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

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

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

GoogleAdsService สามารถแสดงผลลัพธ์ได้ 2 วิธี ดังนี้

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

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

ส่งคำขอ

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

• customer_id
• query ในภาษาของคำค้นหาของ Google Ads ซึ่งระบุทรัพยากรที่จะค้นหา แอตทริบิวต์ กลุ่ม และเมตริกที่จะดึงข้อมูล รวมถึงเงื่อนไขที่จะใช้เพื่อจำกัดออบเจ็กต์ที่จะแสดงผล
• (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 ไม่ได้ ตัวอย่างเช่น แคมเปญหรือโฆษณาใหม่ที่เปิดตัวใน 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 จะมี 1 แถวสำหรับชุดค่าผสมแต่ละชุดของรายการต่อไปนี้

• 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