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 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, 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ệ.
  • Không đủ điều kiện postalAddress.countryCode để bán lại Google Workspace.
  • alternateEmail không được ở 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 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 có thể đã gây ra lỗi này:

  • Bạn không thể giảm số lượng chỗ cho các loại gói hằng năm. Hãy cân nhắc thay đổi chế độ cài đặt việc gia hạn. để gói thuê bao tự động đặt (vào thời điểm gia hạn) số lượng người dùng bằng với số lượng người dùng đang hoạt động trong tài khoản.
  • Số lượng chỗ bạn yêu cầu ít hơn số người dùng hiện tại trong tài khoản. Nhắn tin cho khách hàng rằng họ phải xoá người dùng thì mới có thể giảm số lượng giấy phép.
  • Bạn đã tăng sai thông số về chỗ ngồi. Đố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 giấy phép tối đa là 10. 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 tính phí và xoá giới hạn tối đa 10 chỗ.

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ý 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ễ dự phòng. Để biết thêm thông tin, hãy xem bài viết Hạn mức và hạn ngạch sử dụng.

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 lượt đăng ký 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 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 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 đó hiệ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 kế hoạch thanh toán cam kết sau:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Nếu bạn gặp phải 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ị nào trong 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 gặp phải lỗi này khi sử dụng phương thức subscriptions.insert, tức 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 đ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ố lượng 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 có thời gian đợ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 bài viết Hạn mức và hạn ngạch sử dụng.

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 lượt đăng ký 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 tài khoản đại lý.