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