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

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

به طور کلی، این مقاله به شما نشان می‌دهد که چگونه می‌توانید با استفاده از API گوگل سرچ کنسول، داده‌های مفیدتری استخراج کنید تا به بهبود سئو وب‌سایتتان کمک کنید.

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

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

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

در ادامه، نحوه استفاده از API را بررسی خواهیم کرد تا بتوانید اطلاعات مورد نیاز خود را به راحتی استخراج کنید و به بهبود سئوی وب‌سایتتان کمک کنید.

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

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

مشکلات خروجی

مسئله دیگر مربوط به خروجی است:

1. داده‌های عملکرد برای کوئری‌ها و صفحات باید به صورت جداگانه صادر شوند.
2. صادرات یا خروجی به 1000 ردیف محدود می‌شود.

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

در ادامه، به بررسی نحوه استفاده از این API و چگونگی بهبود فرآیند استخراج داده‌ها خواهیم پرداخت.

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

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

مزایای استفاده از GSC API

• اتصال داده‌ها: با استفاده از API، می‌توانیم داده‌های کوئری را به صفحه‌ای که درخواست برای آن رتبه‌بندی شده متصل کنیم. این بدان معناست که دیگر نیازی به کلیک بر روی صفحات مختلف و انتظار برای بارگذاری اطلاعات نداریم.

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

چرا باید از GSC API استفاده کرد؟

با استفاده از GSC API، می‌توانیم داده‌های دقیق‌تری را استخراج کنیم و به تحلیل‌های عمیق‌تری در مورد عملکرد وب‌سایت خود بپردازیم. این رابط به ما این امکان را می‌دهد که یک مجموعه داده قوی‌تر و معنادارتر به دست آوریم که به بهبود استراتژی سئو کمک می‌کند.

راه‌اندازی GSC API

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

با این کار، می‌توانید به آسانی به امکانات GSC API دسترسی پیدا کرده و از قابلیت‌های آن بهره‌برداری کنید.

راه‌اندازی درخواست خود

برای راه‌اندازی درخواست به API گوگل سرچ کنسول، مراحل زیر را دنبال کنید:

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

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

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

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

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

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

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

نکته مهم

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

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

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

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

با این تنظیمات، می‌توانید به سادگی داده‌های دقیق‌تری را از گوگل سرچ کنسول استخراج کنید.

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

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

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

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

به نظر می‌رسد در رابط کاربردی گوگل سرچ کنسول معمولی می‌توانید فقط یک فیلتر در هر بعد اعمال کنید. این محدودیت ممکن است کار با داده‌ها را چالش‌برانگیز کند، اما با استفاده از API، شما می‌توانید فیلترهای مختلفی را به صورت همزمان و به شکل دقیق‌تری اعمال کنید. این ویژگی به شما این امکان را می‌دهد که داده‌های خاص و کاربردی‌تری برای بهبود استراتژی سئوی خود به دست آورید.

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

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

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

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

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

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

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

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

تبدیل از JSON به CSV

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

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

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

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

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

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

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

سوالات متداول درباره استخراج داده‌ها از Google Search Console و Google Analytics