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

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

ประเภทคำขอ ข้อจำกัด และรหัสข้อผิดพลาด
การดำเนินการที่มีระดับการเข้าถึงขั้นพื้นฐาน การดำเนินการ API 15,000 รายการต่อวัน RESOURCE_EXHAUSTED
คำขอเปลี่ยนแปลง การดำเนินการ 10,000 รายการต่อคำขอ TOO_MANY_MUTATE_OPERATIONS
คำขอวางแผนบริการ 1 QPS RESOURCE_EXHAUSTED
คำขอบริการอัปโหลด Conversion 2,000 Conversion ต่อคำขอ 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

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

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

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

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

คำขอค้นหา

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

คำขอแบบแบ่งหน้า

ระบบจะไม่นับคำขอที่มีการแบ่งหน้า (เช่น คำขอที่มี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

บริการข้อมูลเชิงลึกของกลุ่มเป้าหมาย

วิธีการต่อไปนี้ภายใน AudienceInsightsService วิธีการ จะขึ้นอยู่กับขีดจำกัดโควต้าที่เฉพาะเจาะจง

บริการอัปโหลด 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

คุณได้รับอนุญาตให้ใช้ตัวระบุผู้ใช้ได้สูงสุด 100,000 รายการ ไม่ว่าจะมีจำนวนการดำเนินการเท่าใดก็ตาม

โควต้าประเภทอื่นๆ

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

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

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

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