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

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

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

คำขอเปลี่ยนแปลง

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

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

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

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