การค้นหา & 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 และ pageToken ไม่จำเป็นต้องใช้ pageSize):

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