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

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

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

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

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

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

ส่งคำขอ

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