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

หากคุณพยายามเรียกข้อมูลการติดตามหลายรายการ ให้ลองใช้เมธอด 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

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

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