ราคา ขีดจำกัด 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 Cloud

ระบบจะนับการค้นหาหรือรายงานรายการเดียวเป็นการดำเนินการ 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