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

หน้านี้อธิบายปัญหาที่พบบ่อยซึ่งคุณอาจพบเมื่อใช้ 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 แล้วเปิดใช้ 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

ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณใช้จำนวนคำค้นหาต่อวินาทีเกินขีดจำกัด หากต้องการแก้ไขปัญหานี้ ให้ใช้กลยุทธ์การลองใหม่แบบ Exponential Backoff หรือแคชผลลัพธ์เพื่อลดการเรียก API ดูข้อมูลเพิ่มเติมได้ที่ ขีดจำกัดและโควต้าการใช้งาน

หากคุณพยายามดึงข้อมูลการสมัครใช้บริการจำนวนมาก ให้ลองใช้เมธอด subscriptions.list โดยไม่ต้องระบุพารามิเตอร์ customerId หรือ subscriptionId คุณแสดงผลการสมัครใช้บริการได้สูงสุด 100 รายการต่อการเรียก ใช้พารามิเตอร์ pageToken เพื่อดึงข้อมูลการสมัครใช้บริการทั้งหมดในบัญชีตัวแทนจำหน่ายต่อไป