מיפויי JSON

כשמשתמשים בממשק 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"
          }
        }
      },
      ...
    ]
  }
]