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

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

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

הערה: בדוגמה מוצגת בקשה בסיסית של HTTP/JSON כמדריך, אבל מומלץ מאוד להשתמש באחת מספריות הלקוח. על סמך gRPC כדי לשלוח את הבקשות שלכם.

הבקשה מכילה HTTP GET שנשלח לשרת של Search Ads 360 Reporting API כתובת ה-URL הבאה:

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

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

בקשה

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

תשובה

{
  "resourceName": "searchAds360Fields/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.

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

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

משאב

לדוגמה, searchAds360Fields/campaign.

השדה של המשאב

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

שדה פילוח

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

מדד

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

אפשר להשתמש בשאילתה כדי לקבל פרטי שדה

אפשר לקבל את פרטי השדה על-ידי שליחת שאילתה אל

https://searchads360.googleapis.com/v0/searchAds360Fields:search

דוגמה 1: שימוש בביטוי רגולרי.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

דוגמה 2: שליחת שאילתות לגבי שדות, מדדים או פלחים ספציפיים.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )