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

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

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

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

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

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

ส่งคำขอ

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

แอตทริบิวต์ selectableWith ในช่องทรัพยากรหรือกลุ่มจะระบุทรัพยากร กลุ่ม หรือเมตริกอื่นๆ ที่เลือกได้ในการค้นหา GAQL เดียวกัน แอตทริบิวต์นี้มีความสำคัญเมื่อคุณต้องการรวมช่องจากทรัพยากรหรือกลุ่มที่ไม่ได้ระบุไว้ในอนุประโยค FROM

เมื่อสร้างการค้นหา GAQL ให้ทำดังนี้

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 ที่ระดับต่อไปนี้

ทรัพยากร

เช่น googleAdsFields/campaign

ช่องของทรัพยากร

เช่น googleAdsFields/campaign.name

ช่องการแบ่งกลุ่ม

เช่น googleAdsFields/segments.ad_network_type

เมตริก

เช่น googleAdsFields/metrics.clicks