Trang này được dịch bởi Cloud Translation API.

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

Trang này mô tả một số vấn đề phổ biến mà bạn có thể gặp phải liên quan đến API dành cho Đại lý.

`400:badRequest`

Lỗi này xảy ra khi gói thuê bao bị tạm ngưng hoặc bị huỷ. Cho thông tin khác, xem 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 khác nhau.

Nếu bạn đang sử dụng phương thức customers.insert, một trong những khách hàng sau các thông số của đối tượng 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 ở cùng một 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ó và hợp lệ cho khách hàng.

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

Bạn không thể giảm số giấy phép cho các loại gói hằng năm. Cân nhắc thay đổi chế độ cài đặt gia hạn. cho gói thuê bao tự động đặt số ghế bằng nhau (tại thời điểm gia hạn) vào số lượng người dùng đang hoạt động trên tài khoản.
Số giấy phép bạn đã yêu cầu ít hơn số người dùng hiện tại trên tài khoản. Nhắn tin cho khách hàng rằng họ phải xoá người dùng trước khi có thể giảm số lượng chỗ ngồi của họ.
Bạn đã tăng thông số ghế không chính xác. Đối với gói FLEX, hãy tăng thông số maximumNumberOfSeats và đối với gói ANNUAL, hãy tăng Tham số numberOfSeats.
Bạn đã cố thay đổi tham số licensedNumberOfSeats, đây là chỉ có thể đọc.
Trong thời gian dùng thử, khách hàng chỉ được có tối đa 10 giấy phép. Bắt đầu sử dụng một 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á 10 giấy phép tối đa.

`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 đã vô hiệu hoá 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 lệnh gọi đến API này. Người nhận giải quyết vấn đề này, triển khai độ trễ thời gian đợi. Để biết thêm thông tin, hãy xem Hạn mức 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 subscriptions.list mà không chỉ định customerId hoặc Tham số subscriptionId. Bạn có thể trả lại tối đa 100 gói thuê bao cho mỗi . Sử dụng thông số pageToken để tiếp tục truy xuất tất cả các kênh đăng ký trong tài khoản người bán lại.

`403:usageLimits.accessNotConfigured`

Lỗi này xảy ra khi bạn không bật API trong dự án trên Google Cloud. Để giải quyết sự cố 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, xem 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 không tồn tại đối với bất kỳ tài khoản Google Workspace nào và 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 subscriptions.changeRenewalSettings hãy đảm bảo rằng bạn chỉ gọi phương thức này trên gói thanh toán cam kết:

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, tức là không có người dùng quản trị trên Google Workspace tài khoản. Để 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, có nghĩa là bạn không thể bán lại SKU đã chọn hoặc cho thị trường mới nổi khách hàng. Để 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. Người nhận giải quyết vấn đề này, triển khai chiến lược thử lại trong thời gian đợi hoặc kết quả lưu trong bộ nhớ đệm để í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.