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 do một số lý do.

Nếu bạn đang sử dụng phương thức customers.insert, thì một trong các tham số đối tượng khách hàng sau đây 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 thể ở cùng miền với customerDomain

Để giải quyết vấn đề này, hãy xác minh rằng các tham số bắt buộc có mặt 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, thì 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 thay đổi chế độ cài đặt gia hạn. cho gói thuê bao để tự động đặt (vào thời điểm gia hạn) số chỗ bằng với số người dùng đang hoạt động trên tài khoản.
  • Số chỗ mà 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ố chỗ.
  • Bạn đã tăng tham số số chỗ 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.
  • Trong thời gian dùng thử, khách hàng có hạn mức tối đa là 10 chỗ. Bắt đầu 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 tính phí và xoá hạn mức tối đa là 10 tài khoản con.

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 của bạn đã tắt quyền truy cập của đại lý bán lại vào Bảng điều khiển dành cho quản trị viên của họ.

403:usageLimits.dailyLimitExceeded

Lỗi này xảy ra khi bạn đã đạt đến hạn mức hằng ngày cho các lệnh gọi đến API này. Để giải quyết vấn đề này, hãy triển khai độ trễ lùi. Để biết thêm thông tin, hãy xem 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ả các gói thuê bao trong một tài khoản đại lý bán lại.

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 bảng điều khiển Google Cloud rồi bật API. Để biết thêm thông tin, hãy xem bài viết 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 do một số 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ì có nghĩa là không có người dùng quản trị viên 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ị viên 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ì có nghĩa là bạn không thể bán lại SKU đã chọn hoặc 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ụ áp dụng.

429:usageLimits.quotaExceeded

Lỗi này xảy ra khi bạn vượt quá hạn mức 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 lùi hoặc lưu kết quả vào bộ nhớ đệm để thực hiện ít lệnh gọi API hơn. Để biết thêm thông tin, hãy xem 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ả các gói thuê bao trong một tài khoản đại lý bán lại.