درخواست API کنسول جستجوی گوگل

چگونه می توانم API کنسول جستجوی گوگل را پرس و جو کنم؟
تجزیه و تحلیل سئو سئوی پیشرفته

اگر حتی برای مدت کوتاهی سئو کار کرده اید، احتمالاً با کنسول جستجوی گوگل (GSC) آشنایی دارید. در این مقاله خواهیم دید که چگونه می توانیم API کنسول جستجوی گوگل را پرس و جو کنیم؟

این ابزاری برای به دست آوردن اطلاعات در مورد وب سایت شما و اثربخشی آن در جستجوی ارگانیک است. با توجه به این، محدودیت های خود را دارد.
اگر هنوز سایت خود را به کنسول جستجوی گوگل اضافه نکرده اید، می توانید از مقاله نحوه افزودن وب سایت به کنسول جستجوی گوگل استفاده کنید.

محدودیت های کنسول جستجوی گوگل

اگرچه GSC دارای چندین بخش است، ما بر روی گزارش پیاده سازی تمرکز خواهیم کرد. دو راه برای دسترسی به این گزارش از داشبورد GSC وجود دارد:

وقتی در گزارش عملکرد هستید، به داده‌ها و صفحات جستجو دسترسی دارید:

این یکی از مشکلات GSC را نشان می دهد: داده های پرس و جو و صفحات جدا شده اند.

به عبارت دیگر، اگر می‌خواهیم درخواستی را ببینیم که صفحه خاصی برای آن رتبه‌بندی می‌شود، ابتدا باید روی «صفحات» کلیک کرده، صفحه را انتخاب کنیم و سپس روی «بازگشت» به «پرسش‌ها» کلیک کنیم. این کمی سخت است

مشکل دیگر (دو قسمت) مربوط به خروجی است:

داده های عملکرد برای پرس و جوها و صفحات باید جداگانه صادر شوند.
خروجی به 1000 خط محدود شده است.
ما برای حل این مشکلات با استفاده از GSC API تلاش خواهیم کرد.

Google Search Console API چیست؟

ما قبلاً می دانیم که رابط GSC محدودیت های خود را دارد: پیوند داده های پرس و جو به داده های صفحه کمی دشوار است و خروجی ها محدود هستند.

اگر رابط کاربری GSC تنظیمات پیش فرض را نشان دهد، GSC API تنظیمات سفارشی ما را نمایش می دهد. این به کمی تلاش بیشتر نیاز دارد، اما به ما کنترل بیشتری می دهد و ویژگی های بیشتری را نشان می دهد (حداقل در زمینه پرس و جو و داده های صفحه).

GSC API راهی برای اتصال به داده‌های حساب شما، ایجاد درخواست‌های سفارشی بیشتر و دریافت خروجی سفارشی‌شده‌تر است. حتی می توانیم تنظیمات پیش فرض کارخانه مانند 1000 خط را دور بزنیم.

چرا باید از این رابط استفاده کنید؟

آیا به یاد دارید که چگونه قبلاً گفتیم که درخواست و داده های صفحه در رابط “vanilla” از هم جدا شده اند؟ خوب، با API، می‌توانیم داده‌ها را از کوئری به صفحه‌ای که کوئری در آن رتبه‌بندی می‌شود، پیوند دهیم، بنابراین دیگر مجبور نیستید جلو و عقب کلیک کنید و منتظر بمانید تا آپلود شود.

علاوه بر این دیدیم که خروجی به 1000 خط محدود شده است. با API می توانیم تا 5000 خط درخواست کنیم که 500٪ افزایش می یابد!

پس بیایید وارد شویم، درخواست خود را ارائه دهیم و مجموعه ای قوی تر و معنادارتر از داده ها را دریافت کنیم.

من در حال تنظیم هستم

به حساب GSC خود وارد شوید (گوشه سمت راست بالا). برای مثال، اگر وب‌سایت من example.com است و می‌توانیم این حساب را در کنسول جستجو تحت a[email protected] ببینیم، این همان حسابی است که ما وارد آن می‌شویم.

URL حساب GSC مناسب را وارد کنید:

درخواست خود را ارسال کنید:

1. تاریخ شروع را تنظیم کنید این باید به صورت: YYYY-MM-DD قالب بندی شود.
2. تاریخ پایان را تعیین کنید
3. اندازه های زیر را تنظیم کنید:

• استعلام

• صفحه

• دستگاه
• و/یا کشور

4. فیلترها را تنظیم کنید (اختیاری). فیلتر باید شامل موارد زیر باشد:
ابعاد (که توضیح دادیم)
اپراتور (اپراتور می تواند: contain، notContains، برابر، notEquals باشد)
بیان (عبارت می تواند هر مقدار مرتبط با ابعاد باشد)
5. حد خط را تنظیم کنید. با GSC API می توانید تا 5000 سفارش دهید!
صفحه ای که در مرحله اول به اشتراک گذاشته شد، همه این تنظیمات را بسیار آسان می کند، اما برای برخی می تواند آزاردهنده و حتی گیج کننده باشد. ما همه این کارها را انجام دادیم و یک JSON ایجاد کردیم که می توانید به سرعت و به راحتی آن را ویرایش کنید تا API مورد نظر خود را دریافت کنید.

پرس و جو فیلتر نشده

درخواست زیر فیلتر خواهد شد. ما تاریخ ها، اندازه ها و محدودیت های ردیف های دلخواه خود را مشخص می کنیم و سپس درخواست خود را ارسال می کنیم.

ترتیبی که ابعاد خود را بر اساس آن قرار می دهید، ترتیبی است که آنها برمی گردند.

API از داده‌های رایانه‌های رومیزی، موبایل و تبلت‌ها به‌طور جداگانه پشتیبان‌گیری می‌کند. اعدادی که در رابط GSC می بینید – مانند کلیک ها – مجموع این سه هستند (مگر اینکه فیلتر دستگاه را اعمال کنید).

به یاد داشته باشید که در صورت تمایل اندازه های شما می تواند شامل “کشور” باشد.

{

"startDate": "2019-11-01",

"endDate": "2020-01-31",

"dimensions":

[

"query",

"page",

"device"

],

"rowLimit": 3000

}

{

"startDate": "2019-11-01",

"endDate": "2020-01-31",

"dimensions":

[

"query",

"page",

"device"

],

"rowLimit": 3000

}

پرس و جو فیلتر شده

این نسخه از جستار ما شامل فیلترهایی است تا در مورد آنچه که برگردانده می شود دقیق تر باشد.

فیلترها به صورت ابعاد / عملگر / عبارت بیان می شوند. در اینجا چند مثال برای نشان دادن آنچه می تواند باشد وجود دارد:

این نرم افزار حاوی go fish digital است.
صفحه برابر است با https://gofishdigital.com/
دستگاه حاوی تبلت نیست.
به نظر می رسد که شما می توانید در هر زمان فقط یک فیلتر اعمال کنید، درست مانند یک رابط معمولی GSC.

{

“تاریخ شروع”: “01-11-2019″،

“تاریخ پایان”: “2020-01-31″،

“ابعاد”:

[

“query”,

“page”,

“device”

]،

“DimensionFilterGroups”:

[

{

“filters”:

[

{

“dimension”: “device”,

“operator”: “notContains”,

“expression”: “tablet”

}

]

}

]،

“حد خط”: 3000

}

یک الگو، بدون فیلتر یا فیلتر شده انتخاب کنید و مقادیر سفارشی خود را پر کنید (همه چیزهایی که بعد از کولون باید به عنوان مقدار آن به روز شوند، همچنین می توانید این مقادیر را تغییر دهید).

درخواست را تکمیل کنید

خوب! اکنون صاحب آن هستید! دو قالب پرس و جو برای انتخاب و ویرایش به دلخواه. اکنون زمان درخواست است. روی Query Body کلیک کنید، همه آنها را انتخاب کنید و در JSON سفارشی خود جایگذاری کنید:

در اینجا می توانید کلیدها و مقادیر درخواست خود را به صورت دستی تنظیم کنید، اما همانطور که قبلاً گفتیم، این می تواند آزاردهنده و کمی گیج کننده باشد، بنابراین ما این کار را برای شما انجام دادیم.

به پایین اسکرول کنید و روی Run کلیک کنید. ممکن است از شما خواسته شود که در اینجا نیز وارد شوید.

اگر همه چیز به درستی وارد شود و درخواست اجرا شود، API داده های شما را برمی گرداند. اگر با خطا مواجه شدید، ابتدا درخواست خود را بررسی کنید، سپس هر مرحله و سایر داده ها را در صورت لزوم بررسی کنید.

روی کادر پایین سمت راست کلیک کنید (این پاسخ API است)، همه را انتخاب کنید و اطلاعات را کپی کنید.

از JSON به CSV تبدیل کنید

Excel یا Sheets راه بسیار بهتری برای کار با داده است، بنابراین اجازه دهید خروجی JSON خود را به CSV تبدیل کنیم.

از چنین مبدلی استفاده کنید و آن را در خروجی JSON خود قرار دهید. اکنون می توانید CSV را صادر کنید. سرفصل های ستون خود را همانطور که می خواهید به روز کنید.

پرس و جو در مورد داده های شما

اکثر سئوکارها در اکسل بسیار کاربردی هستند، بنابراین اکنون می توانید خروجی برنامه خود را به هر طریقی جستجو کنید.

یکی از رایج ترین کارها جستجوی داده های مربوط به مجموعه خاصی از صفحات است. این کار با افزودن یک بخش به مجموعه صفحات و استفاده از VLOOKUP برای نمایش یک تطابق انجام می شود.

خروجی API صفحه گسترده همچنین رایج ترین اقدامات اکسل مانند مرتب سازی، فیلتر کردن و نمودارها را امکان پذیر می کند.

انتشارات Google Search Console API Query اولین بار در Server.ir | نگرش جهانی، هاست ایرانی.