Google Ads API มีกลไกการดึงข้อมูลแอตทริบิวต์และการรายงานเมตริกแบบรวมที่ช่วยให้คุณสร้างการค้นหาโดยใช้ภาษาการค้นหาของ Google Ads ได้ ซึ่งจะช่วยให้สามารถทำการค้นหาที่ซับซ้อนซึ่งแสดงข้อมูลจำนวนมากเกี่ยวกับบัญชี Google Ads แต่ละบัญชีได้
คุณสร้างการค้นหาได้โดยใช้วิธี Search หรือ SearchStream
ทั้ง 2 วิธีรองรับการค้นหาเดียวกันและแสดงผลลัพธ์ที่เทียบเท่ากัน เมธอด Search จะแสดงผลข้อมูลในหน้าขนาดคงที่ 10,000 แถว ซึ่งช่วยให้คุณทำซ้ำชุดผลลัพธ์โดยใช้การแบ่งหน้าได้ ซึ่งอาจเป็นประโยชน์ในสภาวะที่มีแบนด์วิดท์ต่ำหรือเครือข่ายไม่เสถียร เช่น เพื่อแบ่งกลุ่มชุดผลลัพธ์ขนาดใหญ่ให้เป็นคำตอบที่เล็กลงซึ่งสามารถดึงข้อมูลอีกครั้งได้หากการเชื่อมต่อขาดหายไป ในทางกลับกัน เมธอด SearchStream จะสตรีมชุดผลลัพธ์ทั้งหมดกลับมาในการตอบกลับเดียว ซึ่งอาจมีประสิทธิภาพมากกว่าสำหรับการดึงข้อมูลจำนวนมาก
ทั้ง Search และ SearchStream ใช้ URL ฐานเดียวกัน ดังนี้
https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/googleAds
POST /v26/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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 /v26/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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 (pageToken ไม่จำเป็นสำหรับ SearchStream)
POST /v26/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_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'" }