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

คุณสามารถใช้ SearchAds360FieldService เพื่อขอแคตตาล็อกทรัพยากร ฟิลด์ของทรัพยากร SearchAds360Service และSearchStream แบบไดนามิกSearch แคตตาล็อกมีข้อมูลเมตาที่ไคลเอ็นต์ 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"
  )