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

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