หน้านี้อธิบายปัญหาที่พบได้ทั่วไปซึ่งคุณอาจพบเกี่ยวกับ 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 นี้ถึงโควต้ารายวันแล้ว ถึง แก้ไขปัญหานี้ และใช้หน่วงเวลาแบ็คออฟ สำหรับข้อมูลเพิ่มเติม โปรดดู ขีดจำกัดการใช้งานและโควต้า
หากต้องการเรียกข้อมูลการสมัครใช้บริการหลายรายการ โปรดพิจารณาใช้
subscriptions.list
โดยไม่ต้องระบุ customerId
หรือ
subscriptionId
พารามิเตอร์ คุณส่งคืนการสมัครใช้บริการได้สูงสุด 100 รายการต่อ
การโทร ใช้พารามิเตอร์ 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
ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณใช้ข้อความค้นหาเกินขีดจำกัดต่อวินาที ถึง แก้ไขปัญหานี้ ใช้กลยุทธ์การลองแบ็คออฟหรือแคชผลลัพธ์เพื่อ จำนวนการเรียก API ที่ลดลง สำหรับข้อมูลเพิ่มเติม โปรดดู ขีดจำกัดการใช้งานและโควต้า
หากต้องการเรียกข้อมูลการสมัครใช้บริการหลายรายการ โปรดพิจารณาใช้
subscriptions.list
โดยไม่ต้องระบุ customerId
หรือ
subscriptionId
พารามิเตอร์ คุณส่งคืนการสมัครใช้บริการได้สูงสุด 100 รายการต่อ
การโทร ใช้พารามิเตอร์ pageToken
เพื่อดึงข้อมูลการสมัครใช้บริการทั้งหมดต่อไป
ภายใต้บัญชีตัวแทนจำหน่าย