ขีดจํากัดและโควต้าของ 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 แต่จะสร้างข้อผิดพลาด 429 Resource Exhausted gRPC ดูรายการรหัสข้อผิดพลาดและข้อความแสดงข้อผิดพลาด 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

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