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

คุณสามารถใช้ GoogleAdsFieldService (ผ่าน GetGoogleAdsField หรือ SearchGoogleAdsFields) เพื่อขอแคตตาล็อกของทรัพยากร ช่องทรัพยากร คีย์การแบ่งกลุ่ม และเมตริกที่มีอยู่ในเมธอด GoogleAdsService Search และ SearchStream แบบไดนามิกได้ แคตตาล็อกมีข้อมูลเมตาที่ไคลเอ็นต์ Google Ads API สามารถใช้เพื่อตรวจสอบและสร้างคำสั่ง Google Ads Query Language ได้

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

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

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

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

ส่งคำขอ

https://googleads.googleapis.com/v26/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 ได้โดยนัยโดยไม่ต้องแบ่งกลุ่มเมตริก จะมีการป้อนข้อมูลเฉพาะช่องที่ category เป็น RESOURCE เท่านั้น
metrics
เมตริกที่เลือกได้พร้อมกับทรัพยากรในส่วนคำสั่ง FROM จะมีการป้อนข้อมูลเฉพาะช่องที่ category เป็น RESOURCE เท่านั้น
segments
คีย์กลุ่ม (ช่อง segments.* และทรัพยากรการแบ่งกลุ่ม) ที่เลือกได้พร้อมกับทรัพยากรในส่วนคำสั่ง FROM ซึ่งจะแบ่งกลุ่มเมตริกที่ระบุในการค้นหา จะมีการป้อนข้อมูลเฉพาะช่องที่ category เป็น RESOURCE เท่านั้น
selectableWith
ทรัพยากร กลุ่ม หรือเมตริกที่เลือกได้ในคำค้นหา Google Ads Query Language เดียวกันเมื่อทรัพยากรหรือกลุ่มนี้ไม่ใช่ทรัพยากรหลักในส่วนคำสั่ง FROM

ค้นหาความเข้ากันได้ด้วย selectableWith

แอตทริบิวต์ selectableWith ในช่องทรัพยากรหรือกลุ่มจะระบุทรัพยากร กลุ่ม หรือเมตริกอื่นๆ ที่สามารถเลือกได้ในการค้นหาด้วย Google Ads Query Language เดียวกัน แอตทริบิวต์นี้มีความสำคัญอย่างยิ่งเมื่อคุณต้องการรวมฟิลด์จากแหล่งข้อมูลหรือกลุ่มที่ไม่ได้ระบุไว้ในส่วนคำสั่ง FROM

เมื่อสร้างคำค้นหาด้วยภาษา Google Ads Query Language ให้ทำดังนี้

  1. ทรัพยากรในส่วนคำสั่ง FROM คือเอนทิตีหลัก คุณเลือกช่องจากแหล่งข้อมูลนี้ได้เสมอ
  2. นอกจากนี้ คุณยังเลือกเมตริกและกลุ่มที่เข้ากันได้ซึ่งใช้ได้กับเอนทิตีหลักได้ด้วย
  3. หากคุณรวมฟิลด์จากแหล่งข้อมูลหรือกลุ่มใดๆ นอกส่วนคำสั่ง FROM คุณต้องตรวจสอบว่าแหล่งข้อมูลหรือกลุ่มที่ไม่ใช่ FROM นี้เข้ากันได้กับฟิลด์ กลุ่ม และเมตริกอื่นๆ ทั้งหมดที่เลือกไว้ในคำค้นหา

รายการ selectableWith สำหรับทรัพยากรที่เฉพาะเจาะจง (ทรัพยากร A) ประกอบด้วยทรัพยากร กลุ่ม และเมตริกอื่นๆ ทั้งหมดที่สามารถเลือกได้พร้อมกับช่องจากทรัพยากร A เมื่อทรัพยากร A ไม่ใช่เอนทิตีหลัก

ตัวอย่าง

ลองดูตัวอย่างการค้นหาต่อไปนี้

SELECT ad_group.id, segments.date, campaign.name FROM ad_group
  • ส่วนคำสั่ง FROM จะระบุ ad_group
  • การค้นหานี้จะเลือก ad_group.id (จากทรัพยากร FROM), segments.date และ campaign.name
  • เนื่องจากมีการเลือก campaign.name แต่ campaign ไม่อยู่ในส่วนคำสั่ง FROM คุณจึงต้องยืนยันความเข้ากันได้กับองค์ประกอบอื่นๆ ที่เลือก
  • เพื่อให้แน่ใจว่าคำค้นหานี้ถูกต้อง ทรัพยากร campaign ต้องเข้ากันได้กับ segments.date (ฟิลด์อื่นที่เลือก) ดังนั้น คุณต้องตรวจสอบแอตทริบิวต์ selectableWith สำหรับทรัพยากร campaign หาก segments.date ปรากฏในรายการ selectableWith ของ campaign แสดงว่าคำค้นหานั้นถูกต้อง

หากคุณเลือกช่องจากแหล่งข้อมูลที่ไม่ได้อยู่ในส่วนคำสั่ง FROM รายการ selectableWith ของแหล่งข้อมูลนั้นต้องมีกลุ่มและแหล่งข้อมูลอื่นๆ ทั้งหมดที่อยู่ในส่วนคำสั่ง SELECT ของคุณ

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

คุณสามารถขอแคตตาล็อกได้โดยใช้ GoogleAdsFieldService (ตามชื่อทรัพยากรที่มี GetGoogleAdsField หรือโดยการค้นหาด้วย SearchGoogleAdsFields) ที่ระดับGoogleAdsFieldCategoryต่อไปนี้

แหล่งข้อมูล (RESOURCE)
เช่น googleAdsFields/campaign
แอตทริบิวต์ทรัพยากร (ATTRIBUTE)
เช่น googleAdsFields/campaign.name
ช่องการแบ่งกลุ่ม (SEGMENT)
เช่น googleAdsFields/segments.ad_network_type
เมตริก (METRIC)
เช่น googleAdsFields/metrics.clicks
ก่อนหน้า
กําลังเรียกออบเจ็กต์
ถัดไป
โครงสร้างการโทร