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'"
}