หน้านี้จะอธิบายปัญหาที่พบบ่อยบางอย่างที่คุณอาจพบเกี่ยวกับ Reseller API
400:badRequest
ข้อผิดพลาดนี้เกิดขึ้นเมื่อการสมัครใช้บริการถูกระงับหรือยกเลิก ดูข้อมูลเพิ่มเติมได้ที่เปิดใช้งานการสมัครใช้บริการ
400:invalid
ข้อผิดพลาดนี้อาจเกิดขึ้นได้จากหลายสาเหตุ
หากคุณใช้วิธี customers.insert
พารามิเตอร์ออบเจ็กต์ลูกค้า
ต่อไปนี้อย่างใดอย่างหนึ่งไม่ถูกต้อง
postalAddress.postalCode
ไม่ถูกต้อง- ไม่มีสิทธิ์
postalAddress.countryCode
ในการขายต่อ Google Workspace alternateEmail
ต้องไม่อยู่ในโดเมนเดียวกับcustomerDomain
หากต้องการแก้ไขปัญหานี้ ให้ตรวจสอบว่ามีพารามิเตอร์ที่จำเป็นและพารามิเตอร์ดังกล่าวถูกต้องสำหรับลูกค้า
หากคุณใช้วิธีsubscriptions.changeSeats
ข้อผิดพลาดนี้อาจเกิดจากปัญหาอย่างใดอย่างหนึ่งต่อไปนี้
- คุณลดจำนวนที่นั่งสำหรับแพ็กเกจรายปีไม่ได้ ลองเปลี่ยนการตั้งค่าการต่ออายุ สำหรับการสมัครใช้บริการให้ตั้งค่าที่นั่งโดยอัตโนมัติ (เมื่อต่ออายุ) ให้เท่ากับ จำนวนผู้ใช้ที่ใช้งานอยู่ในบัญชี
- จำนวนที่นั่งที่คุณขอมีน้อยกว่าจำนวนผู้ใช้ปัจจุบันในบัญชี แจ้งลูกค้าว่าต้องนำผู้ใช้ออกก่อนจึงจะลดจำนวนที่นั่งได้
- คุณเพิ่มพารามิเตอร์ที่นั่งที่ไม่ถูกต้อง สำหรับแพ็กเกจ
FLEX
ให้เพิ่มพารามิเตอร์maximumNumberOfSeats
และสำหรับแพ็กเกจANNUAL
ให้เพิ่มพารามิเตอร์numberOfSeats
- คุณพยายามเปลี่ยนพารามิเตอร์
licensedNumberOfSeats
ซึ่งเป็นพารามิเตอร์แบบ อ่านอย่างเดียว - ในช่วงทดลองใช้ ลูกค้าจะมีขีดจำกัดใบอนุญาตสูงสุด 10 ใบ เริ่มใช้บริการแบบชำระเงินจากการสมัครใช้บริการช่วงทดลองใช้ฟรีเพื่อ สิ้นสุดระยะเวลาทดลองใช้ เริ่มการเรียกเก็บเงิน และนำขีดจำกัดสูงสุด 10 ที่นั่งออกทันที
403:forbidden
ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณไม่ได้เป็นเจ้าของลูกค้าหรือลูกค้าได้ปิดใช้ สิทธิ์เข้าถึงคอนโซลผู้ดูแลระบบของตัวแทนจำหน่าย
403:usageLimits.dailyLimitExceeded
ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณใช้การเรียก API นี้ถึงโควต้ารายวันแล้ว หากต้องการ แก้ไขปัญหานี้ ให้ใช้การหน่วงเวลาแบบ Exponential Backoff ดูข้อมูลเพิ่มเติมได้ที่ โควต้าและขีดจำกัดการใช้งาน
หากคุณพยายามดึงข้อมูลการติดตามจำนวนมาก ให้พิจารณาใช้subscriptions.list
โดยไม่ต้องระบุพารามิเตอร์ customerId
หรือ subscriptionId
คุณส่งคืนการติดตามได้สูงสุด 100 รายการต่อการเรียกใช้ ใช้พารามิเตอร์ pageToken
เพื่อดึงข้อมูลการสมัครใช้บริการทั้งหมดต่อไป
ในบัญชีตัวแทนจำหน่าย
403:usageLimits.accessNotConfigured
ข้อผิดพลาดนี้เกิดขึ้นเมื่อไม่ได้เปิดใช้ API ในโปรเจ็กต์ Google Cloud หากต้องการแก้ไขปัญหานี้ ให้ไปที่ Google Cloud Console แล้วเปิดใช้ 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 รายการต่อการเรียกใช้ ใช้พารามิเตอร์ pageToken
เพื่อดึงข้อมูลการสมัครใช้บริการทั้งหมดต่อไป
ในบัญชีตัวแทนจำหน่าย