แก้ปัญหาเกี่ยวกับตัวแทนจําหน่าย API

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