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

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

ประเภทคำขอ ข้อจำกัด และรหัสข้อผิดพลาด
การดำเนินการที่มีระดับการเข้าถึง Explorer การดำเนินการ API 2,880 รายการต่อวันกับบัญชีที่ใช้งานจริง
การดำเนินการ API 15,000 รายการต่อวันกับบัญชีทดสอบ 		RESOURCE_EXHAUSTED
การดำเนินการที่มีระดับการเข้าถึงพื้นฐาน การดำเนินการ 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 คือผลรวมทั้งหมดของคำขอ get และการดำเนินการ mutate ขีดจำกัดสำหรับการดำเนินการ 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

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

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

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

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