چگونه از API گوگل سرچ کنسول کوئری (query) کنیم؟

اگه حتی برای مدت کوتاهی روی SEO کار کردین، به احتمال زیاد با Google Search Console (GSC) آشنا هستین. گوگل سرچ کنسول یک ابزار ارزشمند برای کسب اطلاعات در مورد وب سایت شما و عملکرد آن در جستجوی ارگانیک است. البته محدودیت هایی هم داره. در این مقاله در وب آنجل آکادمی می آموزین که چگونه داده های متصل بهتری رو از گوگل سرچ کنسول دریافت کنین و همچنین میزان خروجی خود رو افزایش بدین.

محدودیت های گوگل سرچ کنسول (GSC)

در حالی که GSC دارای چندین بخش است، در این مقاله بر روی گزارش عملکرد “Performance” تمرکز خواهم کرد. دو روش برای دسترسی به این گزارش از طریق داشبورد گوگل سرچ کنسول وجود داره:

پس از ورود به گزارش “عملکرد”، می توان به داده های کوئری و صفحات دسترسی پیدا کرد:

این یکی از مشکلات گوگل سرچ کنسول است که داده های کوئری و صفحه از هم جدا شده اند. به عبارت دیگه، اگه می خواهید نمایش داده های مربوط به یک صفحه خاص رو ببینین، ابتدا باید روی “Pages” کلیک کرده، صفحه رو انتخاب کرده و سپس “Back” رو به “Queries” کلیک کنین.

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

• داده های عملکرد برای Query ها و صفحات باید جداگانه صادر بشن.
• صادرات یا خروجی به 1000 ردیف محدود میشه.

من به دنبال حل این مشکلات با استفاده از رابط برنامه نویسی کاربردی گوگل سرچ کنسول (GSC API) هستم.

رابطه برنامه نویسی کاربردی گوگل سرچ کنسول (GSC API) چیست؟

می دانیم که رابط برنامه نویسی کاربردی گوگل سرچ کنسول محدودیت هایی داره: اتصال داده های Query با داده های صفحه مشکل است و صادرات محدود است. اگه رابط برنامه نویسی کاربردی گوگل سرچ کنسول روی حالت پیش فرض باشه، API GSC تنظیمات سفارشی ما رو نشان میده.

تلاش بیشتری نیاز داره، اما کنترل بیشتری به ما میده و امکانات بیشتری رو ایجاد می کنه (حداقل در حوزه Query و داده های صفحه). رابط برنامه نویسی کاربردی گوگل سرچ کنسول راهی است که ما می تونیم به داده های موجود در حساب خود متصل بشیم، درخواست های سفارشی تری ارائه بدیم و خروجی سفارشی تری بگیریم. به عنوان مثال، حتی می تونیم از تنظیمات پیش فرض مانند خروجی محدود به 1000 ردیف عبور کنیم.

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

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

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

راه اندازی

وارد حساب گوگل سرچ کنسول مناسب در این صفحه (گوشه بالا سمت راست) بشین. به عنوان مثال، اگه وب سایت example.com باشه و بتوان آن حساب Search Console رو در hamed@email.com مشاهده کرد، این همان حسابی است که وارد آن خواهید شد. نشانی اینترنتی حساب GSC رو وارد کنین:

درخواست خود رو راه اندازی کنین:

1: تاریخ شروع (Start Date) رو وارد کنین. فرمت آن باید YYYY-MM-DD باشه.

2: تاریخ خاتمه (End Date) رو وارد کنین.

3: ابعاد رو تنظیم کنین. ابعاد می تونه موارد زیر باشه:

• Query
• صفحه
• دستگاه
• و/یا کشور

4: فیلترها رو فعال کنین (انتخابی). یک فیلتر باید شمال موارد زیر باشه:

• ابعاد (در بالا ذکر شد)
• اپراتور (که می تونه محتویات، موارد خارج از محتویات، برابری ها، موارد نابرابر باشه)
• عبارت (که می تونه هر مقدار همبسته با ابعاد باشه)

5: محدودیت ردیف رو تنظیم کنین.

صفحه مشترک شده در مرحله یک، همه این تنظیمات رو بسیار آسان می کنه، اما برای برخی از افراد خسته کننده و حتی گیج کننده است. من همه کارها رو برای شما انجام دادم و JSON ایجاد کردم که می تونین آن رو به سرعت و به راحتی ویرایش کرده تا API مورد نظر خود رو دریافت کنین.

درخواست فیلتر نشده

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

API داده های دسک تاپ، موبایل و رایانه لوحی رو که از یکدیگه جدا شدن، برمی گردونه. اعدادی که در رابط کاربردی گوگل سرچ کنسول مشاهده می کنین- برای مثال کلیک ها- مجموع هر سه داده است (مگه اینکه فیلتر دستگاه رو اعمال کنین). به یاد داشته باشین، در صورت تمایل، ابعاد شما می تونه شامل “کشور” نیز باشه.

} ,”startDate”: “2020-11-01” ,”endDate”: “2021-01-31” :”dimensions” ] ,”query” ,”page” “device” ,[ “rowLimit”: 3000 {

درخواست فیلتر شده

این نسخه از فیلتر شما شامل فیلترهایی میشه تا در مورد آنچه بازگردانده شده، دقیق تر باشین. فیلترها به صورت ابعاد/اپراتور/عبارت بیان میشن. در اینجا چند مثال برای نشان دادن انواع فیلتر های ممکن وجود داره:

• Query شامل seo rooz academy
• صفحه برابر با https://seoroozacademy.com/
• دستگاه حاوی تب لت نیست

به نظر می رسه در رابط کاربردی گوگل سرچ کنسول معمولی می تونین فقط یک فیلتر در هر بعد اعمال کنین.

} ,”startDate”: “2020-11-01” ,”endDate”: “2021-01-31” :”dimensions” ] ,”query” ,”page” “device” ,[ :”dimensionFilterGroups” ] } :”filters” ] } ,”dimension”: “device” ,”operator”: “notContains” “expression”: “tablet” { ] { ,[“rowLimit”: 3000{

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

اجرای درخواست

خب! حالا تنظیمات رو دارین. دو الگوی درخواست برای انتخاب و ویرایش برای شما وجود داره. اکنون وقت اینه که درخواست رو وارد کنین. روی “Request body” کلیک کنین، همه را انتخاب و در JSON سفارشی خود جایگذاری کنین:

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

به پایین صفحه برین و روی “Execute” کلیک کنین. ممکنه در اینجا نیز از شما خواسته بشه وارد سیستم بشین. اگه همه چیز به درستی وارد شده باشه و بتونین درخواست رو اجرا کنین، API داده های شما رو برمی گردونه. در صورت بروز خطا، ابتدا درخواست خود رو بررسی کرده، سپس در صورت لزوم سایر مراحل و ورودی ها رو بررسی کنین. در کادر پایین سمت راست کلیک کرده (این پاسخ API است)، همه رو انتخاب کرده و اطلاعات رو کپی کنین.

تبدیل از JSON به CSV

Excel یا Sheets روش بسیار بهتری برای کار با داده ها خواهد بود، بنابراین بهتره خروجی JSON خود رو به CSV تبدیل کنین. از یک مبدل JSON به CSV که به راحتی با سرچ در گوگل پیدا میشه، استفاده کرده و در خروجی JSON خود جای گذاری کنین. اکنون می تونین CSV صادر کنین. هدرهای ستون خود رو به دلخواه به روز کنین.

داده های خود را Query کنین

بیشتر متخصصان سئو در اکسل بسیار راحت هستن، بنابراین اکنون می تونین به هر روشی که دوست دارین خروجی درخواست خود رو Query کنین. یکی از رایج ترین وظایف انجام شده، جستجوی داده های مرتبط با مجموعه خاصی از صفحات است.

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

از گوگل سرچ کنسول بیشتر استفاده کنین

گوگل سرچ کنسول داده های مهمی رو برای متخصصان سئو ارائه میده و خروجی رابط برنامه نویسی کاربردی گوگل سرچ کنسول نه تنها تعداد بیشتری از این داده ها رو ارائه میده، بلکه در قالبی بسیار دست و پاگیر و جامع تر وجود داره. امروز، یاد گرفتین بر دو مانعی که اغلب در رابط کاربردی استاندارد GSC با آن روبرو هستیم، غلبه کنین: اتصال Query/صفحه و صادرات محدود.

تلاش من اینه که با استفاده از Google Search Console API، تجزیه و تحلیل و بینش شما به سطح بالاتری برسه. در حالی که الگوهای JSON من متداول ترین سناریوها را از نظر خواسته شما برای درخواست پوشش می دهیم، Google اسنادی را ارائه می دهد که در صورت تمایل کمی بیشتر زمینه را پوشش می دهد.