การค้นหา & amp; SearchStream

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