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

คุณสามารถใช้ 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 ข้อความ จะมีการป้อนข้อมูลสำหรับฟิลด์ที่ 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
ก่อนหน้า
กําลังเรียกออบเจ็กต์
ถัดไป
โครงสร้างการโทร