การค้นหา & 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'"
}