Search Ads 360 Reporting API มีกลไกการรายงานการดึงข้อมูลแอตทริบิวต์และเมตริกแบบรวม ที่ช่วยให้คุณสร้างการค้นหาโดยใช้ภาษาสำหรับการค้นหาของ Search Ads 360 ได้ ซึ่งจะช่วยให้เกิดการค้นหาที่ซับซ้อนซึ่งอาจแสดงข้อมูลจำนวนมากเกี่ยวกับบัญชี Search Ads 360 แต่ละบัญชี
คุณจะสร้างการค้นหาโดยใช้เมธอด Search
หรือ SearchStream
ก็ได้
ทั้ง 2 วิธีรองรับคำค้นหาเดียวกันและแสดงผลลัพธ์ที่เทียบเท่ากัน เมธอด Search
จะแสดงผลข้อมูลในขนาดหน้าเว็บที่ปรับแต่งได้ ซึ่งช่วยให้คุณทำซ้ำตามชุดผลลัพธ์โดยใช้การใส่เลขหน้า การทำเช่นนี้อาจเป็นประโยชน์ในกรณีของแบนด์วิดท์ต่ำหรือสภาพเครือข่ายที่ไม่น่าเชื่อถือ ตัวอย่างเช่น ในการแบ่งกลุ่มผลลัพธ์ขนาดใหญ่ให้อยู่ในรูปแบบการตอบสนองที่น้อยลงซึ่งสามารถดึงข้อมูลใหม่ได้หากการเชื่อมต่อขาดหาย ในทางตรงกันข้าม เมธอด SearchStream
จะสตรีมผลลัพธ์ทั้งชุดกลับมาเป็นการตอบกลับครั้งเดียวซึ่งจะทำให้การดึงข้อมูลจำนวนมากมีประสิทธิภาพมากขึ้น
ทั้ง Search
และ SearchStream
ใช้ URL พื้นฐานเดียวกัน ดังนี้
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
วิธีการค้นหาตามหน้าเว็บจะใช้พารามิเตอร์ pageSize
ที่ไม่บังคับ ซึ่งจะจำกัดจำนวนผลลัพธ์ที่จะแสดงในการตอบกลับ API เดียว
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchAds360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "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'" }
หากมีแถวในผลลัพธ์มากกว่า pageSize
ระบบจะแสดงผล nextPageToken
ในคำตอบ
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
การทำซ้ำคำค้นหาเดียวกันที่มี pageToken
เพิ่มเข้ามาด้วยค่าข้างต้นจะดึงผลลัพธ์หน้าถัดไป
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "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
ไม่จำเป็นต้องใช้ pageSize
และ pageToken
) ดังนี้
POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1 Host: searchads360.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'" }