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

หากต้องการเรียกข้อมูลการสมัครใช้บริการหลายรายการ โปรดพิจารณาใช้ 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

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

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