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

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

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

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

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

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

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

בקשה

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

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

מבנה השיחה