מטא-נתונים של משאבים

אפשר להשתמש ב-GoogleAdsFieldService כדי לבקש באופן דינמי מהקטלוג משאבים, שדות של משאבים, מפתחות פילוח ומדדים שזמינים בשיטות GoogleAdsService Search ו-SearchStream. הקטלוג מספק מטא-נתונים שאפשר להשתמש בהם בלקוחות Google Ads API כדי לאמת ולבנות הצהרות של שפת השאילתות של Google Ads.

דוגמה לבקשת HTTP ולתגובה

הבקשה מורכבת מ-HTTP GET לשרת Google Ads API בכתובת ה-URL הבאה:

https://googleads.googleapis.com/v19/googleAdsFields/{resource_or_field}

בהמשך מוצגת דוגמה לבקשה ואחריה התגובה שחוזרת מ-GoogleAdsFieldService למשאב ad_group:

בקשה

https://googleads.googleapis.com/v19/googleAdsFields/ad_group

תשובה

{
  "resourceName": "googleAdsFields/ad_group",
  "name": "ad_group",
  "category": "RESOURCE",
  "selectable": false,
  "filterable": false,
  "sortable": false,
  "selectableWith": [
    "campaign",
    "customer",
    "metrics.average_cpc",
    "segments.device",
    ...
  ],
  "attributeResources": [
    "customer",
    "campaign"
  ],

  "metrics": [
    "metrics.conversions",
    "metrics.search_budget_lost_impression_share",
    "metrics.average_cost",
    "metrics.clicks",
    ...
  ],
  "segments": [
    "segments.date",
    "segments.ad_network_type",
    "segments.device",
    ...
  ]
}

בדוגמה הזו, המערכים החשובים הם:

attributeResources

משאבים שאפשר לצרף באופן משתמע למשאב שבפסקה FROM.

metrics

מדדים שזמינים לבחירה עם המשאב בפסקה FROM. השדה מאוכלס רק בשדות שבהם הערך של category הוא RESOURCE.

segments

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

selectableWith

שדות שאפשר לבחור לצד שדה נתון, כשהם לא נמצאים בפסקה FROM. המאפיין הזה רלוונטי רק כשמזוהים משאבים או פלחים שאפשר לבחור בשאילתה, והם לא כלולים במשאב שבפסקה FROM. לדוגמה, אם בוחרים את ad_group.id ואת segments.date מ-ad_group, ורוצים לכלול מאפיינים מ-campaign, צריך לבדוק ש-segments.date נמצא במאפיין selectableWith בקמפיין, כי הוא נבחר לצד השדה הקיים segments.date.

פרטי המטא-נתונים

אפשר לבקש את הקטלוג באמצעות GoogleAdsFieldService ברמות הבאות:

משאב

לדוגמה, googleAdsFields/campaign.

השדה של המשאב

לדוגמה, googleAdsFields/campaign.name.

שדה פילוח

לדוגמה, googleAdsFields/segments.ad_network_type.

מדד

לדוגמה, googleAdsFields/metrics.clicks.