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

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