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

ניתן לך להשתמש ב-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"
  )