Search Ads 360 Reporting API จะบังคับใช้ขีดจํากัดการทํางานของ API เพื่อให้มั่นใจว่าระบบมีประสิทธิภาพสูงสุดสําหรับผู้ใช้ทั้งหมด
ราคา
การใช้ Search Ads 360 Reporting API จะรวมอยู่ในราคาโดยรวมของ Search Ads 360 ไม่มีค่าธรรมเนียมเพิ่มเติมในการใช้ API
ขีดจำกัดของข้อความค้นหา
ขีดจำกัดต่อไปนี้มีผลกับการดำเนินการค้นหาที่ดำเนินการผ่านเมธอด Search หรือ SearchStream
- การค้นหา 3,000 ครั้งต่อนาทีต่อโปรเจ็กต์ต่อผู้ใช้
- การค้นหา 3,000 ครั้งต่อนาทีต่อโปรเจ็กต์
- การค้นหา 150,000 รายการต่อวันต่อโปรเจ็กต์
ขีดจำกัดการดำเนินการของ API ต่อวัน
ขีดจำกัดการใช้งาน API รายวันจะอิงตามจำนวนการดำเนินการ API ต่อโปรเจ็กต์ Google Cloud แต่ละโปรเจ็กต์
การค้นหาหรือรายงานเดียวจะนับเป็นการดำเนินการ 1 รายการ โดยไม่คำนึงถึงผลลัพธ์ที่สตรีมผ่าน SearchAds360Service.SearchStream
หรือแบ่งหน้าจากการเรียกใช้ SearchAds360Service.Search
ดูข้อมูลเพิ่มเติม
ตารางต่อไปนี้แสดงตัวอย่างการทำบัญชี
คำขอ API | การดำเนินการนับรวมอยู่ในขีดจำกัดรายวันแล้ว |
---|---|
การดำเนินการ: Search
จำนวน: 53 กลุ่มโฆษณา
บริการ: |
1 |
การดำเนินการ: SearchStream
จำนวน: 45 แคมเปญ
บริการ: |
1 |
ระบบจะปฏิเสธคำขอที่ละเมิดขีดจำกัดเหล่านี้โดยมีข้อผิดพลาด RESOURCE_EXHAUSTED
ค้นหาคำขอ
คำขอ Search
หรือ SearchStream
จะนับเป็นการดำเนินการ 1 ครั้งเทียบกับโควต้าการดำเนินการรายวันของผู้ใช้ คำขอ SearchStream
1 รายการจะนับเป็นการดำเนินการ API 1 รายการโดยไม่คำนึงถึงจำนวนกลุ่ม
ข้อจำกัด gRPC
ไลบรารีของไคลเอ็นต์ Search Ads 360 Reporting API ทั้งหมดจะใช้ gRPC เพื่อสร้างคำขอและการตอบกลับ โดยค่าเริ่มต้น gRPC จะมีขนาดข้อความ 4 MB
คำตอบต้องไม่เกินจำนวนที่จำกัดไว้นี้ ตัวอย่างเช่น คำขอค้นหาที่มีหลายช่องอาจสร้างคำตอบที่มีขนาดเกิน 4 MB หากต้องการหลีกเลี่ยงการจำกัดนี้ คุณสามารถลดจำนวนช่องที่เลือก ลดขนาดหน้า หรือใช้สตรีมมิง
คำขอที่ละเมิดข้อจำกัดนี้จะไม่สร้าง SearchAds360Error
แต่จะสร้างข้อผิดพลาด gRPC 429 Resource Exhausted
ดูรายการรหัสข้อผิดพลาดและข้อความแสดงข้อผิดพลาด gRPC
คำขอที่ใส่เลขหน้า
คำขอที่ใส่เลขหน้า (เช่น คำขอที่มี next_page_token
ที่ถูกต้อง) จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้
อย่างไรก็ตาม คำขอการใส่เลขหน้าที่มีโทเค็นหน้าเว็บที่หมดอายุหรือไม่ถูกต้องจะสร้างข้อยกเว้นและนับรวมในโควต้าการดำเนินการรายวัน
คําขอที่ใส่เลขหน้า เช่น คําขอการค้นหา ก็จะขึ้นอยู่กับข้อจํากัด Page size cannot exceed 10,000 rows
เช่นกัน และจะถูกปฏิเสธหากละเมิดขีดจํากัดนี้ โดยมีข้อผิดพลาดดังนี้
INVALID_PAGE_SIZE
ดูรายละเอียดเพิ่มเติมเกี่ยวกับการแบ่งหน้าได้ที่การแบ่งหน้าผ่านผลลัพธ์
คำขอที่ส่งกลับข้อยกเว้น API
คำขอที่ถูกปฏิเสธด้วย SearchAds360Failure
จะยังคงนับรวมในโควต้าการดำเนินการรายวันของผู้ใช้
คำขอที่ล้มเหลวแต่ไม่แสดงผล SearchAds360Failure
เช่น จากข้อผิดพลาดที่ระดับเครือข่าย จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้ เนื่องจากคำขอนั้นส่งไม่ถึงบริการ เช่น ความล้มเหลว
ในการเชื่อมต่อเครือข่าย
ขีดจำกัดประเภทอื่นๆ
ฟิลด์ที่ซ้ำได้ เช่น รายการการดำเนินงาน ที่มีรายการในคำขอมากเกินไป อาจทำให้เกิดข้อผิดพลาดได้: REQUEST_SIZE_LIMIT_EXCEEDED
ข้อความแสดงข้อผิดพลาดเดียวกันนี้อาจเกิดจากปัญหาอื่นๆ ได้เช่นกัน
เมื่อสร้างคำค้นหาภาษาของคำค้นหาใน Search Ads 360 จำนวนรายการสูงสุดภายในวลี IN
คือ 20,000 รายการ หากเกินขีดจำกัด ระบบจะแสดงผลข้อผิดพลาด FILTER_HAS_TOO_MANY_VALUES