หน้านี้จะอธิบายถึงปัญหาทั่วไปที่คุณอาจพบเกี่ยวกับ แผนงาน API
400:badRequest
ข้อผิดพลาดนี้เกิดขึ้นเมื่อการสมัครใช้บริการถูกระงับหรือถูกยกเลิก ดูข้อมูลเพิ่มเติมได้ที่เปิดใช้งานการสมัครใช้บริการ
400:invalid
ข้อผิดพลาดนี้สามารถเกิดขึ้นได้จากหลายสาเหตุ
หากคุณใช้เมธอด customers.insert
พารามิเตอร์ออบเจ็กต์ลูกค้ารายการใดรายการหนึ่งต่อไปนี้ไม่ถูกต้อง
postalAddress.postalCode
ไม่ถูกต้องpostalAddress.countryCode
ไม่มีสิทธิ์สำหรับการเป็นตัวแทนจำหน่าย Google WorkspacealternateEmail
อยู่ในโดเมนเดียวกับcustomerDomain
ไม่ได้
หากต้องการแก้ไขปัญหานี้ ให้ตรวจสอบว่ามีพารามิเตอร์ที่จำเป็นและถูกต้องสำหรับลูกค้า
หากคุณใช้เมธอด subscriptions.changeSeats
ปัญหาใดปัญหาหนึ่งต่อไปนี้อาจทำให้เกิดข้อผิดพลาดนี้
- แต่คุณจะลดจำนวนใบอนุญาตสำหรับประเภทแพ็กเกจรายปีไม่ได้ ลองเปลี่ยนการตั้งค่าการต่ออายุ สำหรับการสมัครใช้บริการเพื่อกำหนดที่นั่งโดยอัตโนมัติ (เมื่อถึงเวลาต่ออายุ) เท่ากับจำนวนผู้ใช้ที่ใช้งานอยู่ในบัญชี
- จำนวนใบอนุญาตที่คุณขอนั้นน้อยกว่าผู้ใช้ปัจจุบันในบัญชี ส่งข้อความถึงลูกค้าว่าต้องนําผู้ใช้ออกก่อนจึงจะลดจํานวนใบอนุญาตได้
- คุณเพิ่มพารามิเตอร์ใบอนุญาตที่ไม่ถูกต้อง สำหรับแผน
FLEX
ให้เพิ่มพารามิเตอร์maximumNumberOfSeats
และสำหรับแผนANNUAL
ให้เพิ่มพารามิเตอร์numberOfSeats
- คุณพยายามเปลี่ยนพารามิเตอร์
licensedNumberOfSeats
ซึ่งเป็นพารามิเตอร์แบบอ่านอย่างเดียว - ในระหว่างช่วงทดลองใช้ ลูกค้าจะมีขีดจำกัดใบอนุญาตสูงสุด 10 ใบ เริ่มต้นบริการที่มีค่าใช้จ่ายจากการสมัครใช้บริการช่วงทดลองใช้ฟรีเพื่อหยุดระยะทดลองทันที เริ่มการเรียกเก็บเงิน และนำขีดจำกัดใบอนุญาตสูงสุด 10 ใบออก
403:forbidden
ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณไม่ได้เป็นเจ้าของลูกค้าหรือลูกค้าปิดใช้การเข้าถึงของตัวแทนจำหน่ายในคอนโซลผู้ดูแลระบบ
403:usageLimits.dailyLimitExceeded
ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณใช้การเรียกไปยัง API นี้ถึงขีดจำกัดโควต้ารายวันแล้ว ในการแก้ปัญหานี้ ให้ใช้การหน่วงเวลา Backoff ดูข้อมูลเพิ่มเติมได้ที่ขีดจำกัดและโควต้าการใช้งาน
หากคุณพยายามเรียกข้อมูลการสมัครใช้บริการจำนวนมาก ลองใช้เมธอด subscriptions.list
โดยไม่ระบุพารามิเตอร์ customerId
หรือ subscriptionId
คุณสามารถส่งคืนการสมัครใช้บริการได้สูงสุด 100 รายการต่อการโทร 1 ครั้ง ใช้พารามิเตอร์ pageToken
เพื่อดึงข้อมูลการสมัครใช้บริการทั้งหมดภายใต้บัญชีตัวแทนจำหน่ายต่อไป
403:usageLimits.accessNotConfigured
ข้อผิดพลาดนี้เกิดขึ้นเมื่อไม่ได้เปิดใช้ API ในโปรเจ็กต์ Google Cloud หากต้องการแก้ไขปัญหานี้ ให้ไปที่คอนโซล Google Cloud และเปิดใช้ API โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเปิดใช้ Google Workspace API
404:notFound
เมื่อใช้เมธอด customers.get
ข้อผิดพลาดนี้หมายความว่าไม่มีลูกค้าหรือโดเมนสำหรับบัญชี Google Workspace และโดเมนดังกล่าวใช้งานได้
412:conditionNotMet
ข้อผิดพลาดนี้เกิดจากปัญหาหลายอย่าง
หากคุณพบข้อผิดพลาดนี้เมื่อใช้เมธอด subscriptions.changeRenewalSettings
ให้ตรวจสอบว่าคุณเรียกใช้เมธอดนี้ในแพ็กเกจการชำระเงินแบบสัญญาผูกมัดต่อไปนี้เท่านั้น
ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY
หากพบข้อผิดพลาดนี้เมื่อใช้เมธอด subscriptions.delete
หมายความว่าไม่มีผู้ใช้ที่ดูแลระบบในบัญชี Google Workspace หากต้องการแก้ไขปัญหานี้ ให้เพิ่มผู้ใช้ที่ดูแลระบบชั่วคราวแล้วลองอีกครั้ง
หากคุณพบข้อผิดพลาดนี้เมื่อใช้เมธอด subscriptions.insert
หมายความว่าคุณไม่สามารถเป็นตัวแทนจำหน่าย SKU ที่เลือกหรือจำหน่ายให้แก่ลูกค้าในตลาดเกิดใหม่ไม่ได้ หากต้องการแก้ไขปัญหานี้ ให้ยอมรับข้อกำหนดในการให้บริการที่เกี่ยวข้อง
429:usageLimits.quotaExceeded
ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณมีข้อความค้นหาต่อวินาทีเกินขีดจำกัด ในการแก้ปัญหานี้ ให้ใช้กลยุทธ์การลองอีกครั้ง Backoff หรือผลลัพธ์แคชเพื่อลดการเรียก API ให้น้อยลง ดูข้อมูลเพิ่มเติมได้ที่ขีดจำกัดและโควต้าการใช้งาน
หากคุณพยายามเรียกข้อมูลการสมัครใช้บริการจำนวนมาก ลองใช้เมธอด subscriptions.list
โดยไม่ระบุพารามิเตอร์ customerId
หรือ subscriptionId
คุณสามารถส่งคืนการสมัครใช้บริการได้สูงสุด 100 รายการต่อการโทร 1 ครั้ง ใช้พารามิเตอร์ pageToken
เพื่อดึงข้อมูลการสมัครใช้บริการทั้งหมดภายใต้บัญชีตัวแทนจำหน่ายต่อไป