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 แต่จะเกิดข้อผิดพลาด 429 Resource Exhausted gRPC โปรดดูรายการรหัสและข้อความแสดงข้อผิดพลาด 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