ข้อมูลเมตาของทรัพยากร

คุณสามารถใช้ GoogleAdsFieldService เพื่อขอแคตตาล็อกแบบไดนามิกสำหรับทรัพยากร ฟิลด์ของทรัพยากร คีย์การแบ่งกลุ่ม และเมตริกที่มีอยู่ในเมธอด GoogleAdsService Search และ SearchStream แคตตาล็อกมีข้อมูลเมตาที่ไคลเอ็นต์ Google Ads API ใช้ได้สำหรับการตรวจสอบและการสร้างคำสั่ง Google Ads Query Language

ตัวอย่างคำขอและการตอบกลับ HTTP

คำขอประกอบด้วย HTTP GET ไปยังเซิร์ฟเวอร์ Google Ads API ที่ URL ต่อไปนี้

https://googleads.googleapis.com/v21/googleAdsFields/{resource_or_field}

ตัวอย่างต่อไปนี้แสดงคำขอและคำตอบที่ส่งคืนจาก GoogleAdsFieldService สำหรับทรัพยากร ad_group

ส่งคำขอ

https://googleads.googleapis.com/v21/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 clause จะมีการป้อนข้อมูลสำหรับฟิลด์ที่ 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