Khắc phục các sự cố về API Đại lý

Trang này mô tả một số vấn đề thường gặp mà bạn có thể gặp phải liên quan đến Reseller API.

400:badRequest

Lỗi này xảy ra khi gói thuê bao bị tạm ngưng hoặc bị huỷ. Để biết thêm thông tin, hãy xem bài viết Kích hoạt gói thuê bao.

400:invalid

Lỗi này có thể xảy ra vì một số lý do.

Nếu bạn đang sử dụng phương thức customers.insert, một trong các tham số đối tượng khách hàng sau đây sẽ không hợp lệ:

  • postalAddress.postalCode không hợp lệ.
  • postalAddress.countryCode không đủ điều kiện để bán lại Google Workspace.
  • alternateEmail không được nằm trong cùng miền với customerDomain

Để giải quyết vấn đề này, hãy xác minh rằng các thông số bắt buộc đều có và hợp lệ đối với khách hàng.

Nếu bạn đang sử dụng phương thức subscriptions.changeSeats, một trong các vấn đề sau đây có thể đã gây ra lỗi này:

  • Bạn không thể giảm số chỗ cho các loại gói hằng năm. Hãy cân nhắc việc thay đổi chế độ cài đặt gia hạn. để gói thuê bao tự động đặt (tại thời điểm gia hạn) số chỗ bằng số người dùng đang hoạt động trên tài khoản.
  • Số chỗ bạn yêu cầu ít hơn số người dùng hiện tại trên tài khoản. Thông báo cho khách hàng rằng họ phải xoá một người dùng thì mới có thể giảm số lượng chỗ ngồi.
  • Bạn đã tăng tham số chỗ ngồi không chính xác. Đối với gói FLEX, hãy tăng tham số maximumNumberOfSeats và đối với gói ANNUAL, hãy tăng tham số numberOfSeats.
  • Bạn đã cố gắng thay đổi tham số licensedNumberOfSeats, đây là tham số chỉ có thể đọc.
  • Trong thời gian dùng thử, khách hàng có hạn mức tối đa là 10 chỗ ngồi. Bắt đầu sử dụng dịch vụ có tính phí từ gói thuê bao dùng thử miễn phí để kết thúc ngay thời gian dùng thử, bắt đầu thanh toán và xoá giới hạn tối đa là 10 chỗ ngồi.

403:forbidden

Lỗi này xảy ra khi bạn không sở hữu khách hàng hoặc khách hàng đã tắt quyền truy cập của đại lý vào Bảng điều khiển dành cho quản trị viên.

403:usageLimits.dailyLimitExceeded

Lỗi này xảy ra khi bạn đã đạt đến hạn mức hằng ngày đối với các lệnh gọi đến API này. Để giải quyết vấn đề này, hãy triển khai độ trễ thời gian đợi. Để biết thêm thông tin, hãy xem phần Hạn mức sử dụng và hạn mức.

Nếu bạn đang cố gắng truy xuất nhiều gói thuê bao, hãy cân nhắc sử dụng phương thức subscriptions.list mà không chỉ định các tham số customerId hoặc subscriptionId. Bạn có thể trả về tối đa 100 gói thuê bao cho mỗi lệnh gọi. Sử dụng tham số pageToken để tiếp tục truy xuất tất cả gói thuê bao trong tài khoản đại lý.

403:usageLimits.accessNotConfigured

Lỗi này xảy ra khi API không được bật trong dự án Google Cloud. Để giải quyết vấn đề này, hãy chuyển đến Google Cloud Console và bật API. Để biết thêm thông tin, hãy xem phần Bật API Google Workspace.

404:notFound

Khi sử dụng phương thức customers.get, lỗi này có nghĩa là khách hàng hoặc miền không tồn tại đối với bất kỳ tài khoản Google Workspace nào và miền đó có sẵn.

412:conditionNotMet

Lỗi này có thể do nhiều vấn đề gây ra.

Nếu bạn gặp lỗi này khi sử dụng phương thức subscriptions.changeRenewalSettings, hãy đảm bảo rằng bạn chỉ gọi phương thức này trên các gói thanh toán cam kết sau:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Nếu bạn gặp lỗi này khi sử dụng phương thức subscriptions.delete, thì điều đó có nghĩa là không có người dùng quản trị nào trên tài khoản Google Workspace. Để giải quyết vấn đề này, hãy thêm một người dùng quản trị tạm thời rồi thử lại.

Nếu bạn gặp lỗi này khi sử dụng phương thức subscriptions.insert, thì điều đó có nghĩa là bạn không thể bán lại SKU đã chọn hoặc bán cho khách hàng ở thị trường mới nổi. Để giải quyết vấn đề này, hãy chấp nhận các điều khoản dịch vụ hiện hành.

429:usageLimits.quotaExceeded

Lỗi này xảy ra khi bạn đã vượt quá giới hạn số truy vấn mỗi giây. Để giải quyết vấn đề này, hãy triển khai chiến lược thử lại thời gian đợi hoặc kết quả bộ nhớ đệm để giảm số lượng lệnh gọi API. Để biết thêm thông tin, hãy xem phần Hạn mức sử dụng và hạn mức.

Nếu bạn đang cố gắng truy xuất nhiều gói thuê bao, hãy cân nhắc sử dụng phương thức subscriptions.list mà không chỉ định tham số customerId hoặc subscriptionId. Bạn có thể trả về tối đa 100 gói thuê bao cho mỗi lệnh gọi. Sử dụng tham số pageToken để tiếp tục truy xuất tất cả gói thuê bao trong tài khoản đại lý.