ניתן לך להשתמש ב-SearchAds360FieldService
כדי לבקש באופן דינמי מהקטלוג משאבים, שדות של משאבים, מפתחות פילוח ומדדים שזמינים בשיטות SearchAds360Service
Search
ו-SearchStream
. בקטלוג יש מטא-נתונים שלקוחות Search Ads 360 Reporting API יכולים להשתמש בהם לצורך אימות ויצירה של הצהרות בשפת השאילתה ב-Search Ads 360.
בקשה ותגובה של HTTP לדוגמה
הבקשה מכילה 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"
)