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