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

คุณใช้ GoogleAdsFieldService (ผ่าน GetGoogleAdsField หรือ SearchGoogleAdsFields) เพื่อขอแคตตาล็อกทรัพยากร ฟิลด์ทรัพยากร คีย์การแบ่งกลุ่ม และเมตริก ที่พร้อมใช้งานในเมธอด 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 อนุประโยคโดยนัยได้โดยไม่ต้องแบ่งกลุ่มเมตริก จะมีการป้อนข้อมูลสำหรับฟิลด์ที่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 ให้ทําดังนี้

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

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

ตัวอย่าง

ลองดูตัวอย่างคำค้นหานี้

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