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

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

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

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

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

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

ส่งคำขอ

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

คำตอบ

{
  "resourceName": "searchAds360Fields/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 ที่มีอยู่

รายละเอียดข้อมูลเมตา

คุณขอแคตตาล็อกได้โดยใช้ SearchAds360FieldService ที่ระดับต่อไปนี้

ทรัพยากร

เช่น searchAds360Fields/campaign

ฟิลด์ของทรัพยากร

เช่น searchAds360Fields/campaign.name

ฟิลด์การแบ่งกลุ่ม

เช่น searchAds360Fields/segments.ad_network_type

เมตริก

เช่น searchAds360Fields/metrics.clicks

ใช้การค้นหาเพื่อดูรายละเอียดของช่อง

คุณดูรายละเอียดฟิลด์ได้โดยส่งการค้นหาไปยัง

https://searchads360.googleapis.com/v0/searchAds360Fields:search

ตัวอย่างที่ 1: การใช้นิพจน์ทั่วไป

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

ตัวอย่างที่ 2: การค้นหาฟิลด์ เมตริก หรือกลุ่มที่เฉพาะเจาะจง

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )