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

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

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

คำขอที่ไม่ใช่คำขอ 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 ลงในชุดกฎตามที่อธิบายไว้ในสร้างชุดกฎ

บริการการเรียกเก็บเงินและงบประมาณบัญชี

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

    ระบบจะปฏิเสธคำขอที่ละเมิดข้อจำกัดนี้โดยแสดงข้อผิดพลาด: 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

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