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