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

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