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