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

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

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

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการแบ่งหน้าได้ที่การเลื่อนดูผลการค้นหา

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

คำขอที่ไม่ใช่คำขอ 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 ในUserData มีมากกว่า 20 รายการ

ขีดจำกัดประเภทอื่นๆ

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

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

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

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