หน้านี้ได้รับการแปลโดย Cloud Translation API

กําลังเรียกออบเจ็กต์

GoogleAdsService เป็นออบเจ็กต์ที่เป็นหนึ่งเดียว บริการดึงข้อมูลและการรายงานของ Google Ads API บริการมีเมธอดที่มีลักษณะดังนี้

ดึงแอตทริบิวต์ที่ระบุของออบเจ็กต์
ดึงข้อมูลเมตริกประสิทธิภาพของออบเจ็กต์ตามช่วงวันที่
เรียงลำดับออบเจ็กต์ตามแอตทริบิวต์
ใช้เงื่อนไขเพื่อระบุออบเจ็กต์ที่คุณต้องการให้แสดงผลในคำตอบ
จำกัดจำนวนออบเจ็กต์ที่แสดงผล

GoogleAdsService จะแสดงผลลัพธ์ใน มี 2 วิธี ได้แก่

GoogleAdsService.SearchStream จะแสดงแถวทั้งหมดในการตอบสนองสตรีมมิงครั้งเดียว ซึ่งมีประสิทธิภาพมากกว่า ขนาดใหญ่ (มากกว่า 10,000 แถว) วิธีนี้อาจเหมาะสมกว่า หากแอปพลิเคชันแบบกลุ่มต้องการดาวน์โหลดข้อมูลมากที่สุด เท่าที่จะเป็นไปได้
การหยุดทำงาน GoogleAdsService.Search คำตอบขนาดใหญ่ไว้ในหน้าผลลัพธ์ที่จัดการได้ อาจมีมากกว่านี้ เหมาะสมหากแอปพลิเคชันแบบอินเทอร์แอกทีฟของคุณแสดงหน้าผลลัพธ์ที่

ดูข้อมูลเพิ่มเติมเกี่ยวกับการแบ่งหน้ากับสตรีมมิง

ส่งคำขอ

วิธีการค้นหาจำเป็นต้องมี SearchGoogleAdsRequest ซึ่งประกอบด้วย แอตทริบิวต์ต่อไปนี้

customer_id
ภาษาในคำค้นหาของ Google Ads query ที่ระบุทรัพยากรที่จะค้นหา แอตทริบิวต์ กลุ่ม และเมตริกที่จะดึงข้อมูล และเงื่อนไขที่ใช้เพื่อจำกัด ออบเจ็กต์ใดบ้างที่แสดงผล
(เฉพาะ GoogleAdsService.Search เท่านั้น) A page_size เพื่อระบุจำนวนออบเจ็กต์ที่จะแสดงผลในคำตอบเดียวเมื่อ โดยใช้การแบ่งหน้า
(เฉพาะ GoogleAdsService.Search เท่านั้น) ตัวเลือก page_token เพื่อเรียกผลลัพธ์ชุดถัดไปเมื่อใช้ การแบ่งหน้า

ดูข้อมูลเพิ่มเติมเกี่ยวกับภาษาของคำค้นหาของ Google Ads ได้ที่ภาษาของคำค้นหาของ Google Ads

ประมวลผลคำตอบ

GoogleAdsService จะแสดงรายการ ออบเจ็กต์ GoogleAdsRow รายการ

GoogleAdsRow แต่ละรายการจะแสดงออบเจ็กต์ที่แสดงผลโดยการค้นหา และประกอบด้วย ชุดแอตทริบิวต์ที่มีการป้อนข้อมูลโดยอิงตามฟิลด์ที่ขอใน SELECT ข้อ แอตทริบิวต์ที่ไม่รวมอยู่ในวรรคคำสั่ง SELECT จะไม่ สร้างขึ้นในออบเจ็กต์ GoogleAdsRow ในคำตอบ

ตัวอย่างเช่น แม้ว่า ad_group_criterion จะมีแอตทริบิวต์ status แต่แอตทริบิวต์ ฟิลด์ status ของแอตทริบิวต์ ad_group_criterion ของแถวไม่ได้ป้อนข้อมูลในฟิลด์ คำตอบสำหรับการค้นหาที่คำสั่ง SELECT ไม่มี ad_group_criterion.status ในทำนองเดียวกัน แอตทริบิวต์ campaign ของแถวคือ จะไม่มีการป้อนข้อมูลหากวรรค SELECT ไม่มีฟิลด์จาก ทรัพยากร campaign รายการ

GoogleAdsRow แต่ละรายการอาจมีแอตทริบิวต์และเมตริกที่แตกต่างกันจากแถวอื่น ในชุดผลลัพธ์เดียวกัน ดังนั้นควรมองว่าแถวเป็นวัตถุ ไม่ใช่ แถวของตาราง

ประเภท enum ที่ไม่รู้จัก

ทรัพยากรที่แสดงผลด้วยประเภท UNKNOWN ไม่ได้รับการสนับสนุนอย่างสมบูรณ์ใน เวอร์ชัน API นั้น ทรัพยากรเหล่านี้อาจสร้างขึ้นผ่านช่องทางอื่นๆ อินเทอร์เฟซอย่างเช่น UI ของ Google Ads คุณเลือกเมตริกได้เมื่อทรัพยากรมี UNKNOWN ได้ แต่จะเปลี่ยนแปลงทรัพยากรผ่าน API ไม่ได้ CANNOT TRANSLATE ตัวอย่างก็คือจะมีการเปิดตัวแคมเปญหรือโฆษณาใหม่ใน UI แต่ ไม่รองรับในเวอร์ชัน API ที่คุณกำลังค้นหา

โปรดคำนึงถึงสิ่งต่อไปนี้

ทรัพยากรที่มีประเภท UNKNOWN จะได้รับการสนับสนุนในภายหลังหรือจะใช้เป็น UNKNOWN ต่อไป ไปเรื่อยๆ
วัตถุใหม่ที่มีประเภท UNKNOWN อาจปรากฏขึ้นได้ตลอดเวลา วัตถุเหล่านี้ แบบย้อนหลังได้เนื่องจากมีค่า enum อยู่แล้ว แหล่งข้อมูล มาพร้อมกับการเปลี่ยนแปลงนี้เมื่อพร้อมใช้งานเพื่อให้คุณมี มุมมองที่ถูกต้องของบัญชี ทรัพยากร UNKNOWN อาจปรากฏเนื่องจาก กิจกรรมใหม่ๆ ในบัญชีผ่านอินเทอร์เฟซอื่นๆ หรือเมื่อแหล่งข้อมูล ไม่ได้รับการสนับสนุนอีกต่อไป
แหล่งข้อมูล UNKNOWN รายการอาจมีเมตริกโดยละเอียดแนบอยู่ซึ่งมีลักษณะดังนี้ สืบค้นได้
โดยทั่วไปทรัพยากร UNKNOWN รายการจะปรากฏโดยสมบูรณ์ใน UI ของ Google Ads
โดยทั่วไปทรัพยากร UNKNOWN รายการจะเปลี่ยนแปลงไม่ได้

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

การตอบกลับจะมี GoogleAdsRow 1 รายการสำหรับชุดค่าผสมแต่ละชุด ดังต่อไปนี้:

อินสแตนซ์ของทรัพยากรหลักที่ระบุในวรรค FROM
ค่าของช่อง segment แต่ละช่องที่เลือก

ตัวอย่างเช่น คำตอบสำหรับคำค้นหาที่เลือก FROM campaign และมี segments.ad_network_type และ segments.date ในวรรค SELECT จะ ประกอบด้วยแถวหนึ่งแถวสำหรับชุดค่าผสมต่อไปนี้แต่ละชุด

campaign
segments.ad_network_type
segments.date

ผลลัพธ์แบ่งกลุ่มตามอินสแตนซ์แต่ละรายการของทรัพยากรหลักโดยปริยาย ไม่ใช่ตาม ค่าของแต่ละฟิลด์ที่เลือก ตัวอย่างเช่น

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

เพื่อให้ได้ผลลัพธ์เป็น 1 แถวต่อแคมเปญ ไม่ใช่ 1 แถวต่อค่าที่ไม่ซ้ำกันของ campaign.status

การเปลี่ยนและตรวจสอบออบเจ็กต์

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