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

หากคุณใช้ข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ เช่น อีเมลหรือหมายเลขโทรศัพท์ที่แฮช โปรดตรวจสอบว่าข้อมูลดังกล่าวได้รับการทำให้เป็นมาตรฐานและแฮชตามข้อกำหนดของ 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 รายการ (an 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

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