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

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

ประเภทคำขอ ขีดจำกัด และรหัสข้อผิดพลาด
การดำเนินการที่มีระดับการเข้าถึง Explorer การดำเนินการ API 2,880 รายการต่อวันกับบัญชีที่ใช้งานจริง
การดำเนินการ API 15,000 รายการต่อวันกับบัญชีทดสอบ 		RESOURCE_EXHAUSTED
การดำเนินการที่มีระดับการเข้าถึง Basic การดำเนินการ API 15,000 รายการต่อวันกับบัญชีทดสอบและบัญชีที่ใช้งานจริง RESOURCE_EXHAUSTED
คำขอเปลี่ยนแปลง การดำเนินการเปลี่ยนแปลง 10,000 รายการต่อคำขอ
การดำเนินการ 100 รายการต่อคำขอ 		TOO_MANY_MUTATE_OPERATIONS
TOO_MANY_ACTION_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 ที่ถูกต้อง) จะไม่นับรวมกับโควต้าการดำเนินการรายวันของผู้ใช้ อย่างไรก็ตาม คำขอแบบแบ่งหน้าที่มีโทเค็นหน้าเว็บที่หมดอายุหรือไม่ถูกต้องจะสร้างข้อยกเว้นและนับรวมกับโควต้าการดำเนินการรายวัน

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

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

คำขอที่ไม่ใช่คำขอ 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

กฎมูลค่า Conversion

  • จำกัดกฎมูลค่า Conversion ไว้ที่ 100,000 รายการต่อบัญชี

    ระบบจะปฏิเสธคำขอที่ละเมิดขีดจำกัดนี้โดยแสดงข้อผิดพลาด ResourceCountLimitExceededError.ACCOUNT_LIMIT

หากบัญชีมี ConversionValueRuleSet ที่มี attachment_type เป็น CUSTOMER อยู่แล้ว คุณต้องเพิ่ม กฎมูลค่า Conversion ใหม่ลงในชุดดังกล่าวเพื่อให้กฎทำงาน หากไม่มีชุดกฎมูลค่า Conversion ดังกล่าว คุณต้องสร้างชุดกฎมูลค่า Conversion และเพิ่มกฎมูลค่า 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 แต่ละรายการในการดำเนินการ create หรือ remove จะเกี่ยวข้องกับ ผู้ใช้ปลายทางรายเดียว ช่อง user_identifiers ภายในออบเจ็กต์ UserData รายการเดียวจะจำกัดไว้ที่ตัวระบุสูงสุด 20 รายการ การระบุตัวระบุเกินขีดจำกัดนี้ในออบเจ็กต์ UserData รายการเดียวจะทำให้เกิดข้อผิดพลาด OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS หรือ UserDataError.TOO_MANY_USER_IDENTIFIERS

จัดการผู้ใช้ที่มีตัวระบุมากกว่า 20 รายการ

หากผู้ใช้ปลายทางรายเดียวมีตัวระบุมากกว่า 20 รายการที่คุณต้องอัปโหลด คุณควรกระจายตัวระบุเหล่านี้ไปยังออบเจ็กต์ UserData หลายรายการ เพื่อให้แน่ใจว่า Google จะเชื่อมโยงตัวระบุทั้งหมดเหล่านี้กับผู้ใช้ปลายทางรายเดียวกันได้ ออบเจ็กต์ UserData แต่ละรายการสำหรับผู้ใช้รายนั้นต้องมี user_identifier ทั่วไปอย่างน้อย 1 รายการ เช่น hashed_email, hashed_phone_number หรือ third_party_user_id เดียวกัน Google จะใช้ตัวระบุที่แชร์เหล่านี้เพื่อลิงก์และผสานข้อมูลจากการดำเนินการ UserData แยกกันเข้ากับโปรไฟล์ผู้ใช้ปลายทางที่ถูกต้อง

หากคุณใช้ข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ เช่น อีเมลหรือหมายเลขโทรศัพท์ที่แฮช โปรดตรวจสอบว่าข้อมูลดังกล่าวได้รับการทำให้เป็นมาตรฐานและแฮชตามข้อกำหนดของ Google Ads API (SHA-256, ตัวพิมพ์เล็ก, ไม่มีช่องว่าง) เพื่อป้องกันไม่ให้เกิดข้อผิดพลาดในการลิงก์

เช่น หากผู้ใช้มีอีเมล 30 รายการ คุณสามารถส่งออบเจ็กต์ UserData 2 รายการได้

  • UserData 1: {third_party_user_id: "user123", hashed_email: "email1@...", ... hashed_email: "email19@..."}
  • UserData 2: {third_party_user_id: "user123", hashed_email: "email20@...", ... hashed_email: "email30@..."}

ขีดจำกัดรวมสำหรับ user_identifiers ในการดำเนินการทั้งหมดใน OfflineUserDataJob รายการเดียวจะยังคงอยู่ที่ 100,000 รายการ

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

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

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

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

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