Google Ads API บังคับใช้ขีดจํากัดการทํางานของ API เช่น จํานวนการดําเนินการ ที่ส่งในคำขอเปลี่ยนแปลงรายการเดียวได้ ตารางด้านล่างแสดงข้อมูลสรุปบางส่วนของ ขีดจำกัดและโควต้าที่สำคัญที่ควรทราบ
ประเภทคำขอ ข้อจำกัด และรหัสข้อผิดพลาด | |||
---|---|---|---|
คำขอที่ใส่เลขหน้า | 10,000 แถวต่อหน้า |
INVALID_PAGE_SIZE
|
|
การดำเนินการที่มีสิทธิ์เข้าถึงพื้นฐาน | การดำเนินการ API 15,000 ครั้งต่อวัน |
RESOURCE_EXHAUSTED
|
|
เปลี่ยนแปลงคำขอ | การดำเนินการ 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 การดำเนินการต่อโทเค็นของนักพัฒนา API คือผลรวมทั้งหมดของคำขอรับและการดำเนินการเปลี่ยนแปลง ขีดจำกัด สำหรับการทำงาน API ประจำวันจะขึ้นอยู่กับระดับการเข้าถึงของโทเค็นของนักพัฒนา คู่มือระดับการเข้าถึงและการใช้งานที่อนุญาตสรุป ขีดจำกัดการดำเนินการของ 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
) จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้
อย่างไรก็ตาม คำขอการใส่เลขหน้าที่มีโทเค็นหน้าเว็บที่หมดอายุหรือไม่ถูกต้องจะ
สร้างข้อยกเว้นและจะนับรวมในโควต้าการดำเนินการรายวัน
คำขอที่ใส่เลขหน้า เช่น คำขอการค้นหา ก็ต้องเป็นไปตาม
การจำกัด Page size cannot exceed 10,000 rows
และถูกปฏิเสธหากละเมิด
ขีดจำกัดนี้ โดยมีข้อผิดพลาด
INVALID_PAGE_SIZE
.
สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการแบ่งหน้า โปรดดูที่ การแบ่งหน้า ผ่าน ผลลัพธ์
คำขอประเภทอื่นๆ
คำขอที่ไม่ใช่คำขอ Get
, Mutate
, Search
หรือ SearchStream
นับเป็นการดำเนินการ 1 รายการที่โควต้าการดำเนินการรายวันของผู้ใช้
ตัวอย่างคำขอดังกล่าว ได้แก่
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
คำขอที่ส่งกลับข้อยกเว้น API
คำขอที่ถูกปฏิเสธที่มี
GoogleAdsFailure
ยังคงนับรวมใน
โควต้าการดำเนินงานรายวันของผู้ใช้
คำขอที่ล้มเหลวแต่ไม่แสดงผล
GoogleAdsFailure
เช่น จากข้อผิดพลาดที่
ระดับเครือข่าย จะไม่นับรวมในโควต้าการดำเนินการรายวันของผู้ใช้
เนื่องจากคำขอนั้นส่งไม่ถึงบริการ ตัวอย่างเช่น
การเชื่อมต่อเครือข่ายล้มเหลว
บริการวางแผน
เนื่องจากค่าใช้จ่ายและความซับซ้อน วิธีบริการการวางแผนที่แสดงด้านล่างมีดังนี้ อยู่ภายใต้ขีดจำกัดที่แยกจากคำขอประเภทอื่นๆ
จำกัดไว้ที่ 1 คำขอต่อวินาทีต่อรหัสลูกค้า:
KeywordPlanIdeaService.GenerateKeywordIdeas
KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
ระบบจะปฏิเสธคำขอที่ละเมิดข้อจำกัดเหล่านี้โดยมีข้อผิดพลาดดังนี้
RESOURCE_EXHAUSTED
.1 QPS คำนวณจากคำขอ 60 รายการต่อ 60 วินาที
จำกัดไว้ที่ 2 คำขอต่อวินาทีต่อรหัสลูกค้า:
โปรดคำนึงถึงขีดจำกัดเหล่านี้เมื่อสร้างแผนคีย์เวิร์ด
ออบเจ็กต์แผนคีย์เวิร์ด | จำนวนสูงสุด |
---|---|
KeywordPlan ต่อบัญชี |
10,000 |
KeywordPlanAdGroup ต่อ KeywordPlan |
200 |
KeywordPlanAdGroupKeyword ต่อ KeywordPlan |
10,000 |
KeywordPlanCampaignKeyword (คีย์เวิร์ดเชิงลบ) |
1,000 |
KeywordPlanCampaign ต่อ KeywordPlan |
1 |
บริการอัปโหลด Conversion
จำกัด Conversion การโทรหรือการคลิกไว้ที่ 2,000 รายการต่อคำขอดังนี้
ระบบจะปฏิเสธคำขอที่ละเมิดขีดจำกัดเหล่านี้โดยมีข้อผิดพลาดดังนี้
TOO_MANY_CONVERSIONS_IN_REQUEST
.
บริการอัปโหลดการปรับ Conversion
จำกัดการปรับ Conversion ไว้ที่ 2,000 รายการต่อคำขอ
ระบบจะปฏิเสธคำขอที่ละเมิดขีดจำกัดเหล่านี้โดยมีข้อผิดพลาดดังนี้
TOO_MANY_ADJUSTMENTS_IN_REQUEST
.
บริการเรียกเก็บเงินและงบประมาณบัญชี
สามารถเปลี่ยนแปลงได้เฉพาะบัญชีที่กำหนดค่าสำหรับการแจ้งหนี้รายเดือนเท่านั้น
ระบบจะปฏิเสธคำขอที่ละเมิดข้อจำกัดนี้โดยมีข้อผิดพลาดดังนี้
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
ที่กำหนดแต่ละรายการ
ชุดของ user_identifiers
ควรเจาะจงสำหรับผู้ใช้รายเดียว
วิธีบังคับใช้มีดังนี้
OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
หรือ
UserDataError.TOO_MANY_USER_IDENTIFIERS
เมื่อมี user_identifiers
มากกว่า 20 รายการใน
ตั้งค่า UserData
แล้ว
ขีดจำกัดประเภทอื่นๆ
ฟิลด์ที่ซ้ำได้ เช่น รายการการดำเนินงาน ที่มีหลายรายการใน
อาจทำให้เกิดข้อผิดพลาดได้:
REQUEST_SIZE_LIMIT_EXCEEDED
.
ข้อความแสดงข้อผิดพลาดเดียวกันนี้อาจเกิดจากปัญหาอื่นๆ ได้เช่นกัน
หากคุณพบข้อจำกัดนี้และส่งคำขอที่ใช้ ให้ลองลดจำนวนรายการในฟิลด์ที่ซ้ำโดยปรับใช้ รายการการดำเนินการในคำขอเปลี่ยนแปลง
เมื่อสร้างคำค้นหา GAQL จำนวนรายการสูงสุด
ภายในวรรค IN
จะเท่ากับ 20,000 หากเกินขีดจำกัด
FILTER_HAS_TOO_MANY_VALUES