คุณสามารถใช้ GoogleAdsFieldService
เพื่อขอแคตตาล็อกสำหรับทรัพยากร ช่องของทรัพยากร คีย์การแบ่งกลุ่มลูกค้า และเมตริกที่มีอยู่ในเมธอด GoogleAdsService
Search และ SearchStream แบบไดนามิก แคตตาล็อกมีข้อมูลเมตาที่ไคลเอ็นต์ Google Ads API นำไปใช้เพื่อตรวจสอบความถูกต้องและสร้างคำสั่งสำหรับภาษาการค้นหาของ Google Ads ได้
ตัวอย่างคำขอ HTTP และการตอบกลับ
คำขอประกอบด้วย HTTP GET
ไปยังเซิร์ฟเวอร์ Google Ads API ที่ URL ต่อไปนี้
https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}
ต่อไปนี้คือตัวอย่างของคำขอ ตามด้วยการตอบกลับจาก GoogleAdsFieldService
สำหรับทรัพยากร ad_group
ส่งคำขอ
https://googleads.googleapis.com/v17/googleAdsFields/ad_group
คำตอบ
{
"resourceName": "googleAdsFields/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
ที่มีอยู่
รายละเอียดข้อมูลเมตา
คุณขอแคตตาล็อกโดยใช้ GoogleAdsFieldService
ได้ที่ระดับต่อไปนี้
- ทรัพยากร
- เช่น
googleAdsFields/campaign
- ช่องของแหล่งข้อมูล
- เช่น
googleAdsFields/campaign.name
- ฟิลด์การแบ่งกลุ่ม
- เช่น
googleAdsFields/segments.ad_network_type
- เมตริก
- เช่น
googleAdsFields/metrics.clicks