คุณสามารถใช้ 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"
)