חיפוש & SearchStream

ב-Search Ads 360 Reporting API יש דוחות מאוחדים לאחזור מאפיינים ולמדדים מנגנון שמאפשר ליצור שאילתות באמצעות השאילתה של Search Ads 360 שפה. כך ניתן להציג שאילתות מורכבות שיכולות להחזיר כמויות גדולות של נתונים בחשבונות Search Ads 360 אישיים.

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

Search ו-SearchStream משתמשים באותה כתובת URL בסיסית:

    https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360

שיטת החיפוש מבוסס-הדף מקבלת פרמטר pageSize אופציונלי, שמגביל את השימוש כמה תוצאות מוחזרות בתגובה אחת מה-API.

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchAds360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
"pageSize": 10000,
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}

אם התוצאות כוללות יותר שורות מאשר pageSize, הערך של nextPageToken הוא שמוחזר בתשובה:

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

חזרה על אותה שאילתה עם pageToken שנוסף עם הערך שלמעלה לאחזור דף התוצאות הבא:

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN


{
"pageSize": 10000,
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}

כדי להשתמש בשיטה SearchStream, שמחזירה את כל התוצאות בשידור יחיד בסטרימינג תגובה, פשוט משנים את שיטת השירות בכתובת ה-URL ל-searchStream (pageSize ו-pageToken לא נדרשים על ידי SearchStream):

POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
    "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}