Google Search Console API کیسے استعمال کریں؟

Google Cloud console میں ایک پروجیکٹ بنائیں، Google Search Console API فعال کریں، OAuth 2.0 credentials بنائیں، اور ایسے Google اکاؤنٹ سے سائن اِن کریں جسے پراپرٹی تک رسائی حاصل ہو۔ اس کے بعد آپ چار وسائل (resources) کو درخواستیں بھیج سکتے ہیں: کلکس، امپریشنز، CTR اور پوزیشن کے لیے Search Analytics؛ انڈیکس کی حالت کے لیے URL Inspection؛ Sitemaps؛ اور Sites۔ صرف API keys کام نہیں کرتیں: ہر کال کے لیے OAuth ٹوکن درکار ہے، اور کوٹے طے کرتے ہیں کہ آپ کتنا ڈیٹا مانگ سکتے ہیں۔

API کیا کچھ فراہم کرتی ہے اور کیا نہیں

بس یہی پوری API ہے۔ Links، Crawl stats، Page indexing رپورٹ اور Core Web Vitals رپورٹ کا کوئی endpoint موجود نہیں، اس لیے یہ Search Console کے انٹرفیس تک ہی محدود رہتی ہیں۔ URL Inspection وہ دکھاتا ہے جو Google کے انڈیکس میں موجود ہے، یہ صفحے کا لائیو ٹیسٹ نہیں ہے۔

رسائی کی ترتیب

1. Google Cloud console میں ایک پروجیکٹ بنائیں یا موجودہ پروجیکٹ منتخب کریں۔
2. اس پروجیکٹ کے لیے Google Search Console API فعال کریں۔
3. OAuth consent screen ترتیب دیں اور OAuth client ID بنائیں۔
4. ایک scope کی درخواست کریں: پڑھنے کے لیے https://www.googleapis.com/auth/webmasters.readonly، یا سائٹ میپس جمع کرانے یا حذف کرنے کے لیے بھی https://www.googleapis.com/auth/webmasters۔
5. ایسے اکاؤنٹ سے سائن اِن کریں جسے پراپرٹی پر اجازت حاصل ہو۔ کارکردگی کا ڈیٹا پڑھنے کے لیے کم از کم read رسائی درکار ہے؛ API وہی کچھ دیکھتی ہے جو وہ اکاؤنٹ دیکھتا ہے۔

آپ کی پہلی Search Analytics کوئری

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

سائٹ کو راستے (path) میں URL-encoded شکل میں دیا جاتا ہے: Domain پراپرٹی کے لیے sc-domain:example.com، یا URL-prefix پراپرٹی کے لیے آخری سلیش سمیت عین prefix، جیسے https://www.example.com/۔ سب سے اہم فیلڈز یہ ہیں:

• تاریخیں شامل (inclusive) ہوتی ہیں اور Pacific Time میں ہیں۔
• type بطور ڈیفالٹ web ہے؛ دیگر image، video، news، googleNews اور discover ہیں۔ ہر ایک کے لیے الگ درخواست درکار ہے۔
• فلٹرز dimensionFilterGroups میں جاتے ہیں، جن کے آپریٹرز equals اور contains سے لے کر includingRegex اور excludingRegex (RE2 syntax) تک ہیں۔
• rowLimit 1 سے 25,000 تک ہوتی ہے (ڈیفالٹ 1,000)؛ باقی قطاروں کے لیے startRow سے صفحہ بندی کریں۔
• dataState بطور ڈیفالٹ final ہے؛ all تازہ، نامکمل دن شامل کرتا ہے اور hourly_all hour dimension کے ساتھ کام کرتا ہے۔

ہر قطار keys، clicks، impressions، ctr (0 سے 1) اور position واپس کرتی ہے، اور جب تک آپ تاریخ کے لحاظ سے گروپ نہ کریں، کلکس کے مطابق ترتیب دی جاتی ہے۔

وہ حدود جو آپ کے کوڈ کو تشکیل دیتی ہیں

• فی دن فی سرچ ٹائپ 50,000 قطاریں۔ startRow کے ذریعے 25,000 کے قدموں میں صفحہ بندی کریں اور خالی جواب آنے پر رک جائیں۔ زیادہ سے زیادہ ڈیٹا حاصل کرنے کے لیے ایک وقت میں ایک دن کی کوئری کریں۔
• لوڈ کوٹا۔ صفحے اور کوئری دونوں کے لحاظ سے گروپ یا فلٹر کرنا سب سے مہنگی درخواست ہے، اور لمبی تاریخی حدیں مختصر حدوں سے زیادہ لاگت رکھتی ہیں۔ اگر آپ مختصر مدت کا کوٹا عبور کر جائیں تو Google آپ سے 15 منٹ انتظار کرنے کو کہتا ہے۔
• درخواستوں کی شرح۔ فی سائٹ اور فی صارف 1,200 کوئریز فی منٹ؛ فی پروجیکٹ 40,000 فی منٹ اور 30,000,000 فی دن۔
• URL Inspection کوٹا۔ ہر پراپرٹی کے لیے 2,000 معائنے فی دن اور 600 فی منٹ۔
• 16 ماہ کی تاریخ، اور ڈیٹا عموماً دن ختم ہونے کے دو سے تین دن بعد دستیاب ہوتا ہے۔
• قطاریں مجموعے کے برابر نہیں ہوتیں۔ نایاب کوئریز کوئری سطح کی قطاروں سے خارج کر دی جاتی ہیں، اور صفحے کے لحاظ سے گروپ کرنے پر امپریشنز پراپرٹی کے لحاظ سے گروپ کرنے سے مختلف انداز میں گنے جاتے ہیں، اس لیے مجموعے اس درخواست سے پڑھیں جس میں query dimension شامل نہ ہو۔

عام غلطیاں

• جب پراپرٹی https:// ہو تو http:// استعمال کرنا، یا آخری سلیش چھوڑ دینا، اجازت کی خرابی دیتا ہے چاہے اکاؤنٹ کو رسائی حاصل ہو۔
• URL Inspection میں پراپرٹی سے باہر کا URL مانگنا مسترد ہو جاتا ہے: URL اس siteUrl کے تحت ہونا چاہیے جو آپ دیتے ہیں۔
• ایک مہینے کو ایک ہی کال میں کوئری اور صفحے کے لحاظ سے گروپ کرنے سے صرف اوپر کی قطاریں ملتی ہیں۔ روزانہ کی درخواستیں زیادہ قطاریں واپس کرتی ہیں۔

AutoPSEO کیسے مدد کرتا ہے

اگر آپ OAuth اور صفحہ بندی خود سنبھالنا نہیں چاہتے تو AutoPSEO Google سائن اِن کے ذریعے جڑتا ہے اور وہی ڈیٹا اپنی REST API کے ذریعے /v1 پر (OpenAPI 3.1 دستاویز کے ساتھ) اور ایک MCP server کے ذریعے فراہم کرتا ہے، جس کی اجازت Account → API keys سے حاصل کردہ API key دیتی ہے۔ صرف پڑھنے والی keys دستیاب ہیں، search analytics endpoint ہر کال میں 5,000 قطاریں تک واپس کرتا ہے، اور ایپ کے URL Inspection ٹولز Google کے 2,000 روزانہ کوٹے کا حساب آپ کے لیے رکھتے ہیں۔ دیکھیں MCP and API keys۔ پائپ لائن لکھے بغیر 16 ماہ سے زیادہ پرانا ڈیٹا محفوظ رکھنے کے لیے دیکھیں Search Console ڈیٹا کتنی دیر محفوظ رکھتا ہے۔

ماخذ: Google کے API reference، Search Analytics query method، usage limits، getting all your data اور authorisation guide۔