ขีดจํากัดและโควต้าของ 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

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