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

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

ประเภทคำขอ ข้อจำกัด และรหัสข้อผิดพลาด
การดำเนินการที่มีระดับการเข้าถึง Explorer การดำเนินการ API 2,880 รายการต่อวันกับบัญชีที่ใช้งานจริง
การดำเนินการ API 15,000 รายการต่อวันกับบัญชีทดสอบ 		RESOURCE_EXHAUSTED
การดำเนินการที่มีระดับการเข้าถึงขั้นพื้นฐาน การดำเนินการ 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 แต่จะสร้างข้อผิดพลาด 429 Resource Exhausted gRPC ดูรายการรหัสและข้อความแสดงข้อผิดพลาดของ gRPC

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

นอกเหนือจากการนับรวมในโควต้าการดำเนินการรายวันของผู้ใช้แล้ว คำขอ mutate ต้องมีการดำเนินการไม่เกิน 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

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

เมธอดต่อไปนี้ภายในเมธอด 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 ข้อความแสดงข้อผิดพลาดเดียวกันนี้อาจเกิดจากปัญหาอื่นๆ ด้วย

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

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

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