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