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