Search Analytics

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

אין נתונים קבועים שמשויכים למשאב הזה.

שיטות

שאילתה

הרצת שאילתות על נתוני תנועת החיפוש באמצעות מסננים ופרמטרים שאתם מגדירים. השיטה מחזירה אפס שורות או יותר שמקובצות לפי מפתחות השורות (מאפיינים) שהגדרתם. עליך להגדיר טווח תאריכים של יום אחד או יותר.

כשתאריך הוא אחד מהמאפיינים, ימים ללא נתונים מושמטים מרשימת התוצאות. כדי לדעת באילו ימים יש נתונים, אפשר ליצור שאילתה ללא מסננים שמקובצים לפי תאריך, בטווח התאריכים הרצוי.

התוצאות ממוינות לפי מספר הקליקים בסדר יורד. אם בשתי שורות יש אותו מספר קליקים, הן ממוינות באופן שרירותי.

כדי להפעיל את השיטה הזו, אפשר לעיין בדוגמת python.

ה-API מוגבל במגבלות פנימיות של Search Console ואינו מבטיח להחזיר את כל הפריטים שורות נתונים אלא את השורות העליונות.

כאן מפורטות המגבלות של כמות הנתונים הזמינים.

דוגמה ל-POST בפורמט JSON:

POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}