ขีดจํากัดและโควต้าของ API

Google Ads API บังคับใช้ขีดจํากัดการทํางานของ API เช่น จํานวนการดําเนินการ ที่ส่งในคำขอเปลี่ยนแปลงรายการเดียวได้ ตารางต่อไปนี้สรุปข้อมูล ขีดจำกัดและโควต้าที่สำคัญบางประการที่ควรทราบ

ประเภทคำขอ ข้อจำกัด และรหัสข้อผิดพลาด
การดำเนินการที่มีสิทธิ์เข้าถึงพื้นฐาน การดำเนินการ API 15,000 ครั้งต่อวัน RESOURCE_EXHAUSTED
เปลี่ยนแปลงคำขอ การดำเนินการ 10,000 รายการต่อคำขอ TOO_MANY_MUTATE_OPERATIONS
คำขอบริการการวางแผน 1 QPS RESOURCE_EXHAUSTED
คำขอบริการอัปโหลด Conversion Conversion 2,000 ครั้งต่อคำขอ TOO_MANY_CONVERSIONS_IN_REQUEST
คำขอบริการเรียกเก็บเงินและงบประมาณบัญชี การดำเนินการ 1 รายการต่อคำขอเปลี่ยนแปลง TOO_MANY_MUTATE_OPERATIONS

ขีดจำกัดการดำเนินการของ API ต่อวัน

ขีดจำกัดการใช้งาน API รายวันขึ้นอยู่กับจำนวน API การดำเนินการต่อโทเค็นของนักพัฒนา API คือผลรวมทั้งหมดของคำขอรับและการดำเนินการเปลี่ยนแปลง ขีดจำกัด สำหรับการทำงาน API ประจำวันจะขึ้นอยู่กับระดับการเข้าถึงของโทเค็นของนักพัฒนา คู่มือระดับการเข้าถึงและการใช้งานที่อนุญาตสรุป ขีดจำกัดการดำเนินการของ API สำหรับแต่ละระดับการเข้าถึง

ระบบจะปฏิเสธคำขอที่ละเมิดขีดจำกัดเหล่านี้โดยมีข้อผิดพลาดดังนี้ RESOURCE_EXHAUSTED

ข้อจำกัด gRPC

ไลบรารีของไคลเอ็นต์ Google Ads API ทั้งหมดใช้ gRPC สำหรับการสร้างคำขอและการตอบกลับ โดยค่าเริ่มต้น gRPC จะมีค่า ขนาดข้อความ 4 MB แต่ไลบรารีของไคลเอ็นต์ของเรากำหนดขนาดข้อความสูงสุดเป็น 64 MB เพื่อเพิ่มประสิทธิภาพ

คำตอบต้องไม่เกินจำนวนที่จำกัดไว้นี้ ตัวอย่างเช่น คำขอการค้นหาที่ มีช่องหลายช่องที่อาจสร้างคําตอบที่มีขนาดใหญ่กว่า 64 MB ถึง เพื่อเลี่ยงการจำกัดนี้ คุณสามารถ ลดจำนวนฟิลด์ที่เลือก หรือใช้ สตรีมมิง ส่งการดำเนินการน้อยลงสำหรับการกลายพันธุ์ ต่อคำขอ

คำขอที่ละเมิดข้อจำกัดนี้จะไม่สร้าง GoogleAdsError แต่จะสร้าง ข้อผิดพลาด gRPC 429 Resource Exhausted รายการ โปรดดูรายการรหัสข้อผิดพลาด gRPC และ ข้อความ

เปลี่ยนแปลงคำขอ

นอกจากการนับ โควต้าการดำเนินการรายวันของผู้ใช้ แล้ว ยัง คำขอไม่สามารถมีการดำเนินการได้มากกว่า 10,000 รายการต่อคำขอ

ระบบจะปฏิเสธคำขอที่ละเมิดข้อจำกัดนี้โดยมีข้อผิดพลาดดังนี้ TOO_MANY_MUTATE_OPERATIONS

ข้อจำกัดและข้อควรพิจารณาเพิ่มเติมสำหรับบริการและประเภทคำขอที่เฉพาะเจาะจงมีดังนี้ สรุปเป็นลำดับถัดไป

ค้นหาคำขอ

คำขอ Search หรือ SearchStream นับเป็น 1 การดำเนินการกับคำขอของผู้ใช้ โควต้าการดำเนินการรายวัน คำขอ SearchStream 1 รายการนับเป็นการดำเนินการ API 1 รายการ โดยไม่คำนึงถึงจำนวนแบตช์

คำขอที่ใส่เลขหน้า

คำขอที่ใส่เลขหน้า (ตัวอย่างเช่น คำขอที่มี next_page_token) จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้ อย่างไรก็ตาม คำขอการใส่เลขหน้าที่มีโทเค็นหน้าเว็บที่หมดอายุหรือไม่ถูกต้องจะ สร้างข้อยกเว้นและจะนับรวมในโควต้าการดำเนินการรายวัน

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการแบ่งหน้า โปรดดูที่ การแบ่งหน้า ผ่าน ผลลัพธ์

คำขอประเภทอื่นๆ

คำขอที่ไม่ใช่คำขอ Get, Mutate, Search หรือ SearchStream นับเป็นการดำเนินการ 1 รายการที่โควต้าการดำเนินการรายวันของผู้ใช้

ตัวอย่างคำขอดังกล่าว ได้แก่

คำขอที่ส่งกลับข้อยกเว้น API

คำขอที่ถูกปฏิเสธที่มี GoogleAdsFailure ยังคงนับรวมใน โควต้าการดำเนินงานรายวันของผู้ใช้

คำขอที่ล้มเหลวแต่ไม่แสดงผล GoogleAdsFailure เช่น จากข้อผิดพลาดที่ ระดับเครือข่าย จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้ เนื่องจากคำขอนั้นส่งไม่ถึงบริการ ตัวอย่างเช่น การเชื่อมต่อเครือข่ายล้มเหลว

บริการวางแผน

เนื่องจากค่าใช้จ่ายและความซับซ้อน วิธีบริการการวางแผนต่อไปนี้ อยู่ภายใต้ขีดจำกัดที่แยกจากคำขอประเภทอื่นๆ

โปรดคำนึงถึงขีดจำกัดเหล่านี้เมื่อสร้างแผนคีย์เวิร์ด

ออบเจ็กต์แผนคีย์เวิร์ด จำนวนสูงสุด
KeywordPlan ต่อบัญชี 10,000
KeywordPlanAdGroup ต่อ KeywordPlan 200
KeywordPlanAdGroupKeyword ต่อ KeywordPlan 10,000
KeywordPlanCampaignKeyword (คีย์เวิร์ดเชิงลบ) 1,000
KeywordPlanCampaign ต่อ KeywordPlan 1

บริการอัปโหลด Conversion

บริการอัปโหลดการปรับ Conversion

บริการเรียกเก็บเงินและงบประมาณบัญชี

  • สามารถเปลี่ยนแปลงได้เฉพาะบัญชีที่กำหนดค่าสำหรับการแจ้งหนี้รายเดือนเท่านั้น

    ระบบจะปฏิเสธคำขอที่ละเมิดข้อจำกัดนี้โดยมีข้อผิดพลาดดังนี้ MUTATE_NOT_ALLOWED

  • อนุญาตให้ดำเนินการเพียง 1 อย่างสำหรับคำขอเปลี่ยนแปลง

    ระบบจะปฏิเสธคำขอที่ละเมิดข้อจำกัดนี้โดยมีข้อผิดพลาดดังนี้ TOO_MANY_MUTATE_OPERATIONS

  • คุณควรรออย่างน้อย 12 ชั่วโมงระหว่างที่ทำการเปลี่ยนแปลงคำสั่งซื้อตามงบประมาณ บัญชีเดียวกัน การเปลี่ยนแปลงใดๆ ก่อนที่จะครบ 12 ชั่วโมงอาจส่งผลให้เกิด ความล้มเหลวที่กู้คืนไม่ได้ซึ่งแก้ไขได้โดยบัญชี Google Ads เท่านั้น ตัวแทน

คำเชิญไปยังบัญชีลูกค้า

คุณสามารถเชิญผู้ใช้ใหม่ให้เข้าร่วมบัญชีลูกค้าที่มีอยู่ได้โดยใช้ CustomerUserAccessService เพราะ ฟีเจอร์นี้จะส่งอีเมลคำเชิญไปยังผู้ใช้รายอื่นๆ ถูกนำไปใช้ในทางที่ผิด ลักษณะการทำงานจึงมีข้อจำกัดดังนี้

  • ผู้ใช้ไม่สามารถรับคำเชิญที่รอดำเนินการมากกว่า 1 รายการสำหรับลูกค้ารายเดียวกัน ของคุณได้ หากมีการส่งคำขอให้ส่งคำเชิญไปยังผู้ใช้ในภายหลัง ที่มีคำเชิญที่รอดำเนินการอยู่แล้ว ระบบจะแสดงข้อผิดพลาดนี้ ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION

  • บัญชีลูกค้ามีคำเชิญที่รอดำเนินการพร้อมกันได้ไม่เกิน 70 รายการ หากมีการส่งคำขอที่ทำให้เกินค่านี้ ข้อผิดพลาดนี้จะแสดง ส่งคืนแล้ว: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED

ข้อมูลผู้ใช้

ข้อมูลผู้ใช้มีการจัดการด้วย UserDataService และ OfflineUserDataJobService ในการสร้างหรือนำออก UserData แต่ละรายการ ชุดของ user_identifiers ควรเจาะจงสำหรับผู้ใช้รายเดียว

วิธีบังคับใช้มีดังนี้ OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS หรือ UserDataError.TOO_MANY_USER_IDENTIFIERS เมื่อมี user_identifiers มากกว่า 20 รายการใน ตั้งค่า UserData แล้ว

ขีดจำกัดประเภทอื่นๆ

ฟิลด์ที่ซ้ำได้ เช่น รายการการดำเนินงาน ที่มีหลายรายการใน อาจทำให้เกิดข้อผิดพลาดได้: REQUEST_SIZE_LIMIT_EXCEEDED ข้อความแสดงข้อผิดพลาดเดียวกันนี้อาจเกิดจากปัญหาอื่นๆ ได้เช่นกัน

หากคุณพบข้อจำกัดนี้และส่งคำขอที่ใช้ ให้ลองลดจำนวนรายการในฟิลด์ที่ซ้ำโดยปรับใช้ รายการการดำเนินการในคำขอเปลี่ยนแปลง

เมื่อสร้างคำค้นหา GAQL จำนวนรายการสูงสุด ภายในวรรค IN จะเท่ากับ 20,000 หากเกินขีดจำกัด FILTER_HAS_TOO_MANY_VALUES