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

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

ประเภทคำขอ ข้อจำกัด และรหัสข้อผิดพลาด
คำขอที่ใส่เลขหน้า 10,000 แถวต่อหน้า INVALID_PAGE_SIZE
การดำเนินการที่มีสิทธิ์เข้าถึงพื้นฐาน การดำเนินการ 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) จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้ อย่างไรก็ตาม คำขอการใส่เลขหน้าที่มีโทเค็นหน้าเว็บที่หมดอายุหรือไม่ถูกต้องจะ สร้างข้อยกเว้นและจะนับรวมในโควต้าการดำเนินการรายวัน

คำขอที่ใส่เลขหน้า เช่น คำขอการค้นหา ก็ต้องเป็นไปตาม การจำกัด Page size cannot exceed 10,000 rows และถูกปฏิเสธหากละเมิด ขีดจำกัดนี้ โดยมีข้อผิดพลาด INVALID_PAGE_SIZE.

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

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

คำขอที่ไม่ใช่คำขอ 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

ก่อนหน้า
ภาพรวม
ถัดไป
ข้อจำกัดของระบบ