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

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