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

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

ประเภทคำขอ ข้อจำกัด และรหัสข้อผิดพลาด
การดำเนินการที่มีระดับการเข้าถึงแบบทดสอบ การดำเนินการ API 15,000 ครั้งต่อวันสำหรับบัญชีทดสอบ RESOURCE_EXHAUSTED
การดำเนินการที่มีระดับการเข้าถึงแบบ Explorer การดำเนินการ API 2,880 ครั้งต่อวันสำหรับบัญชีที่ใช้งานจริง
การดำเนินการ API 15,000 ครั้งต่อวันสำหรับบัญชีทดสอบ 		RESOURCE_EXHAUSTED
การดำเนินการที่มีระดับการเข้าถึงแบบพื้นฐาน การดำเนินการ API 15,000 ครั้งต่อวันสำหรับทั้งบัญชีทดสอบและบัญชีที่ใช้งานจริง RESOURCE_EXHAUSTED
การดำเนินการที่มีสิทธิ์การเข้าถึงระดับมาตรฐาน การดำเนินการ API ไม่จำกัดต่อวันสำหรับทั้งบัญชีทดสอบและบัญชีที่ใช้งานจริง ไม่มี
คำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์ การดำเนินการเปลี่ยนแปลง 10,000 รายการต่อคำขอ TOO_MANY_MUTATE_OPERATIONS
คำขอบริการวางแผน 1 QPS RESOURCE_EXHAUSTED
คำขอบริการอัปโหลด Conversion Conversion 2,000 รายการต่อคำขอ TOO_MANY_CONVERSIONS_IN_REQUEST
คำขอ Billing and Account Budget Service การดำเนินการ 1 รายการต่อคำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์ TOO_MANY_MUTATE_OPERATIONS

ขีดจำกัดการดำเนินการ API ต่อวัน

ขีดจำกัดการใช้งาน API รายวันจะขึ้นอยู่กับจำนวนการดำเนินการของ API ที่โปรเจ็กต์ Google Cloud ทำ การดำเนินการของ API คือผลรวมของคำขอ Search และ SearchStream, การดำเนินการเปลี่ยนแปลงแต่ละรายการ และคำขอบริการอื่นๆ ขีดจำกัดสำหรับการดำเนินการ API รายวันขึ้นอยู่กับระดับการเข้าถึง API ของโปรเจ็กต์ Google Cloud คู่มือระดับการเข้าถึงและการใช้งานที่อนุญาตจะระบุขีดจำกัดการดำเนินการของ API ที่เฉพาะเจาะจงสำหรับระดับการเข้าถึงแต่ละระดับ

คำขอที่ละเมิดขีดจำกัดเหล่านี้จะถูกปฏิเสธพร้อมข้อผิดพลาดต่อไปนี้ RESOURCE_EXHAUSTED

ข้อจำกัดของ gRPC

ไลบรารีของไคลเอ็นต์ Google Ads API ทั้งหมดใช้ gRPC เพื่อสร้างคำขอและการตอบกลับ โดยค่าเริ่มต้น gRPC จะมีขนาดข้อความ 4 MB แต่ไลบรารีของไคลเอ็นต์ของเราจะกำหนดขนาดข้อความสูงสุดเป็น 64 MB เพื่อเพิ่มประสิทธิภาพ

คำตอบต้องไม่เกินขีดจำกัดนี้ ตัวอย่างเช่น คำขอค้นหาที่มีช่องจำนวนมากอาจสร้างการตอบกลับที่มีขนาดเกิน 64 MB เพื่อหลีกเลี่ยงขีดจำกัดนี้ คุณสามารถลดจำนวนฟิลด์ที่เลือก หรือใช้สตรีมมิง สําหรับการเปลี่ยนแปลง ให้ส่งการดำเนินการต่อคําขอน้อยลง

คำขอที่ละเมิดข้อจำกัดนี้จะไม่สร้าง GoogleAdsError แต่จะสร้างข้อผิดพลาด RESOURCE_EXHAUSTED (รหัส gRPC 8 / HTTP 429) โปรดดูรายการรหัสข้อผิดพลาดและข้อความของ gRPC

คำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์

นอกจากจะนับรวมในโควต้าการดำเนินการรายวันของผู้ใช้แล้ว คำขอเปลี่ยนแปลงข้อมูลในเซิร์ฟเวอร์ยังต้องมีการดำเนินการเปลี่ยนแปลงข้อมูลไม่เกิน 10,000 รายการต่อคำขอด้วย คำขอที่ละเมิดข้อจำกัดนี้จะถูกปฏิเสธพร้อมข้อผิดพลาด TOO_MANY_MUTATE_OPERATIONS

ขีดจำกัดและข้อควรพิจารณาเพิ่มเติมสำหรับบริการและประเภทคำขอที่เฉพาะเจาะจงจะระบุไว้ด้านล่าง

คำขอการค้นหา

คำขอ Search หรือ SearchStream จะนับเป็นการดำเนินการ 1 ครั้งเทียบกับโควต้าการดำเนินการรายวันของผู้ใช้ คำขอ SearchStream 1 รายการจะนับเป็นการดำเนินการ API 1 รายการ ไม่ว่าจะมีกี่กลุ่มก็ตาม

คำขอที่มีการแบ่งหน้า

คำขอที่มีการแบ่งหน้า (เช่น คำขอที่มี next_page_token ที่ถูกต้อง) จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้ อย่างไรก็ตาม คำขอการแบ่งหน้าที่มีโทเค็นหน้าเว็บที่หมดอายุหรือไม่ถูกต้องจะสร้างข้อยกเว้นและจะนับรวมในโควต้าการดำเนินการรายวัน

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

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

คำขอที่ไม่ใช่คำขอ Mutate, Search หรือ SearchStream จะนับเป็นการดำเนินการ 1 ครั้งเทียบกับโควต้าการดำเนินการรายวันของผู้ใช้

ตัวอย่างคำขอประเภทนี้ ได้แก่

คำขอที่แสดงผลข้อยกเว้น API

คำขอที่ถูกปฏิเสธด้วย GoogleAdsFailure จะยังคงนับรวมในโควต้าการดำเนินการรายวันของผู้ใช้

คำขอที่ล้มเหลวแต่ไม่แสดง GoogleAdsFailure เช่น จากข้อผิดพลาดที่ระดับเครือข่าย จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้ เนื่องจากคำขอจะไม่ไปถึงบริการ ตัวอย่างเช่น การเชื่อมต่อเครือข่ายล้มเหลว

บริการวางแผนคีย์เวิร์ด

เนื่องจากต้นทุนและความซับซ้อน เมธอดบริการการวางแผนคีย์เวิร์ดต่อไปนี้จึงมีขีดจํากัดแยกต่างหากจากคําขอประเภทอื่นๆ

โปรดคำนึงถึงขีดจำกัดเหล่านี้เมื่อสร้างแผนคีย์เวิร์ด

ออบเจ็กต์แผนคีย์เวิร์ด จำนวนสูงสุด
KeywordPlan ต่อ 1 บัญชี 10,000
KeywordPlanAdGroup ต่อ KeywordPlan 200
KeywordPlanAdGroupKeyword ต่อ KeywordPlan 10,000
KeywordPlanCampaignKeyword (คีย์เวิร์ดเชิงลบ) ต่อ KeywordPlan 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 ชั่วโมงระหว่างการเปลี่ยนแปลงงบประมาณบัญชี (AccountBudget หรือ AccountBudgetProposal) ในบัญชีเดียวกัน การเปลี่ยนแปลงก่อนครบ 12 ชั่วโมงอาจส่งผลให้เกิดความล้มเหลวที่กู้คืนไม่ได้ ซึ่งแก้ไขได้โดยตัวแทนฝ่ายดูแลลูกค้าของบัญชี Google Ads เท่านั้น

คำเชิญให้เข้าถึงบัญชีลูกค้า

คุณสามารถเชิญผู้ใช้ใหม่ให้เข้าร่วมบัญชีลูกค้าที่มีอยู่ได้ด้วยเมธอด CustomerUserAccessInvitationService เนื่องจากฟีเจอร์นี้จะส่งอีเมลคำเชิญไปยังผู้ใช้รายอื่น จึงอาจมีการนำไปใช้ในทางที่ผิด ดังนั้นจึงมีข้อจำกัดเกี่ยวกับลักษณะการทำงานของฟีเจอร์นี้ ดังนี้

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

  • บัญชีลูกค้ามีคำเชิญที่รอดำเนินการพร้อมกันได้ไม่เกิน 70 รายการ หากมีการส่งคำขอที่ทำให้ค่านี้เกินขีดจำกัด ระบบจะแสดงข้อผิดพลาดต่อไปนี้ 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 ที่แยกกันไปยังโปรไฟล์ผู้ใช้ปลายทางที่ถูกต้อง

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

เช่น หากผู้ใช้มีอีเมล 30 รายการ คุณสามารถส่งออบเจ็กต์ UserData 2 รายการที่แชร์ third_party_user_id ร่วมกัน (โดยใส่ออบเจ็กต์ thirdPartyUserId และอีเมล 1 ถึง 19 ในออบเจ็กต์แรกเพื่อให้อยู่ภายในขีดจำกัดตัวระบุ 20 รายการ และใส่ออบเจ็กต์ thirdPartyUserId และอีเมล 20 ถึง 30 ในออบเจ็กต์ที่ 2) ดังนี้

{
  "userIdentifiers": [
    { "thirdPartyUserId": "user123" },
    { "hashedEmail": "SHA256_OF_EMAIL_1" },
    // Hashed emails 2 through 18 are omitted here.
    { "hashedEmail": "SHA256_OF_EMAIL_19" }
  ]
}

{
  "userIdentifiers": [
    { "thirdPartyUserId": "user123" },
    { "hashedEmail": "SHA256_OF_EMAIL_20" },
    // Hashed emails 21 through 29 are omitted here.
    { "hashedEmail": "SHA256_OF_EMAIL_30" }
  ]
}

ขีดจำกัดรวมสำหรับ user_identifiers ในการดำเนินการทั้งหมดใน AddOfflineUserDataJobOperationsRequest เดียวคือ 100,000 (OfflineUserDataJob สามารถรับการเรียก AddOfflineUserDataJobOperationsRequest ได้หลายครั้ง สูงสุดไม่เกิน 1,000,000 การดำเนินการต่องานตามที่แนะนำ) สำหรับการอัปโหลดแบบซิงโครนัสโดยใช้ UploadUserDataRequest (UserDataService.UploadUserData) คำขอแต่ละรายการจะจำกัดการดำเนินการไว้สูงสุด 10 รายการและ 100 user_identifiers ในคำขอทั้งหมด

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

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

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

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

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