דף זה תורגם על ידי Cloud Translation API.

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

אפשר להשתמש ב-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.

מתבצע אחזור של אובייקטים

מבנה השיחה