Google Ads API มีกลไกการดึงข้อมูลแอตทริบิวต์และการรายงานเมตริกแบบรวมที่ให้คุณสร้างการค้นหาโดยใช้ภาษาการค้นหาของ Google Ads ซึ่งทำให้เกิดการค้นหาที่ซับซ้อนซึ่งสามารถแสดงข้อมูลจำนวนมากเกี่ยวกับบัญชี Google Ads แต่ละบัญชี
คุณสามารถสร้างการค้นหาได้โดยใช้เมธอด Search หรือ SearchStream
ทั้ง 2 วิธีรองรับคําค้นหาเดียวกันและแสดงผลลัพธ์ที่เทียบเท่า เมธอด Search จะแสดงผลลัพธ์ในหน้าขนาดคงที่ 10,000 แถว ซึ่งช่วยให้คุณวนซ้ำชุดผลลัพธ์ได้โดยใช้การแบ่งหน้า ซึ่งอาจมีประโยชน์ในกรณีที่แบนด์วิดท์ต่ำหรือเครือข่ายไม่น่าเชื่อถือ เช่น แบ่งกลุ่มชุดผลลัพธ์ขนาดใหญ่ออกเป็นคำตอบขนาดเล็กที่ดึงข้อมูลอีกครั้งได้หากการเชื่อมต่อขาดหายไป ในทางตรงกันข้าม เมธอด SearchStream จะสตรีมผลลัพธ์ทั้งชุดกลับเข้าไปในคำตอบเดียว ซึ่งมีประสิทธิภาพมากกว่าสำหรับการดึงข้อมูลจำนวนมาก
ทั้ง Search และ SearchStream ใช้ URL พื้นฐานเดียวกัน
https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds
POST /v18/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
หากผลลัพธ์มีแถวมากกว่า 10,000 แถว ระบบจะแสดง nextPageToken ในการตอบกลับ
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
การค้นหาเดียวกันซ้ำโดยเพิ่ม pageToken พร้อมค่าจากคำขอก่อนหน้าจะดึงข้อมูลหน้าถัดไปของผลลัพธ์
POST /v18/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
หากต้องการใช้เมธอด SearchStream ซึ่งแสดงผลลัพธ์ทั้งหมดในการตอบกลับแบบสตรีมเดียว ให้เปลี่ยนเมธอดบริการใน URL เป็น searchStream (SearchStream ไม่จำเป็นต้องใช้ pageToken)
POST /v18/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }