ราคา ขีดจำกัด API และโควต้า

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

ระบบจะนับคำค้นหาหรือรายงานเดียวเป็นการดำเนินการ 1 รายการ ไม่ว่าผลลัพธ์จะสตรีมผ่าน SearchAds360Service.SearchStream หรือมีการแบ่งหน้าจาก SearchAds360Service.Search การเรียกก็ตาม ดูข้อมูลเพิ่มเติม

ตารางต่อไปนี้แสดงตัวอย่างการบัญชี

คำขอ API	การดำเนินการที่นับรวมในขีดจำกัดการใช้งานต่อวัน
การดำเนินการ: Search จำนวน: กลุ่มโฆษณา 53 กลุ่ม บริการ: SearchAds360Service	1
การดำเนินการ: SearchStream จำนวน: 45 แคมเปญ บริการ: SearchAds360Service	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 Query Language จำนวนรายการสูงสุดภายในคําสั่ง IN คือ 20,000 รายการ หากเกินขีดจำกัดดังกล่าว ระบบจะแสดงข้อผิดพลาด FILTER_HAS_TOO_MANY_VALUES