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