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

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

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

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

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

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

בקשה

https://googleads.googleapis.com/v17/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.