ราคา ขีดจำกัด 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 จำนวนรายการสูงสุดภายในวลี IN คือ 20,000 รายการ หากเกินขีดจำกัด ระบบจะแสดงผลข้อผิดพลาด FILTER_HAS_TOO_MANY_VALUES