כשמשתמשים בממשק REST של Search Ads 360 Reporting API, עובדים עם ייצוגים של JSON של אותם משאבים וסוגים שמוגדרים בקובצי .proto של Search Ads 360 Reporting API. סכימת הקידוד של JSON תואמת לסכימת הקידוד הקנונית המתוארת בקטע מיפוי JSON של הפרוטוקול, כדי לחבר את מדריך השפות.
באופן כללי, כל ההודעות ברמה העליונה לשירותים ומהם הם אובייקטים נפרדים ב-JSON. תגובות search
הן אובייקטים בפורמט JSON שמכילים מערך results
עם קבוצת התוצאות של השאילתה.
המזהים משתנים מ-snake_case (במאגרי פרוטוקולים) ל-lowerCamelCase ב-JSON. יש לשים לב לכלל הזה כשמשתמשים ב-search
או ב-searchStream
כדי לשלוח שאילתות בשפת השאילתות של Search Ads 360. בשפת השאילתה עצמה נעשה שימוש באותיות נחש, ללא קשר לממשק שבו אתם משתמשים. עם זאת, התוצאות של שאילתה ב-REST מוחזרות כאובייקטים רגילים של JSON, והמזהים שלהן מופיעים ב-lowerCamelCase.
לדוגמה, שאילתה לאחזור רשימה של מילות מפתח פעילות בחשבון משתמשת באותיות נחש בתוך השאילתה עצמה (ad_group_criterion
, לא adGroupCriterion
):
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 FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
עם זאת, התגובה היא ייצוג JSON של האובייקטים (ארוזים במערך JSON, כי הבקשה הזו משתמשת ב-searchStream
) ומשתמשת במזהה CamlCase adGroupCriterion
במקום זאת:
[ { "results": [ { "adGroupCriterion": { "resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060", "keyword": { "text": "pay per click" } } }, ... ] } ]