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

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

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

หมายเหตุ: ตัวอย่างนี้แสดงคําขอ HTTP/JSON พื้นฐานเพื่อเป็นแนวทาง แต่เราขอแนะนําอย่างยิ่งให้ใช้ไลบรารีไคลเอ็นต์อย่างใดอย่างหนึ่งที่อิงตาม gRPC เพื่อส่งคําขอ

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

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

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

ส่งคำขอ

https://googleads.googleapis.com/v19/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