Khắc phục sự cố về Directory API

Trang này mô tả một số vấn đề thường gặp mà bạn có thể gặp phải khi là đại lý bán lại Directory API.

400:badRequest

Lỗi này xảy ra khi một giá trị tham số không chính xác được truyền vào phương thức.

Nếu sử dụng phương thức users.get, hãy xác minh rằng giá trị được truyền vào tham số userKey là địa chỉ email chính, địa chỉ email đại diện hoặc mã nhận dạng người dùng duy nhất của người dùng.

Nếu sử dụng phương thức users.list, hãy xác minh các thông số sau:

  • Tham số customer: Chỉ sử dụng customerId do Google tạo. Đừng sử dụng miền thực tế của khách hàng. Bạn nên sử dụng thông số này vì nếu khách hàng có miền phụ, thì việc sử dụng thông số domain sẽ chỉ trả về những người dùng có địa chỉ email trên miền cụ thể đó.
  • Tham số domain: Chỉ sử dụng miền thực tế của khách hàng. Không sử dụng
    customerId do Google tạo.

403:domainCannotUseApis

Lỗi này xảy ra khi khách hàng của bạn đã tắt quyền truy cập của đại lý vào API SDK dành cho quản trị viên. Để giải quyết vấn đề này, hãy yêu cầu khách hàng bật lại quyền truy cập vào API SDK dành cho quản trị viên. Để biết thêm thông tin, hãy xem phần Kiểm soát quyền truy cập API.

Nếu bạn đang cố gắng lấy số lượng người dùng hiện có giấy phép và gặp lỗi này, thay vì gọi phương thức users.list, hãy sử dụng trường licensedNumberOfSeats từ tài nguyên gói thuê bao.

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.

Để giải quyết vấn đề này, hãy gọi phương thức customers.get trước khi thực hiện các lệnh gọi để xác minh quyền sở hữu của đại lý đối với khách hàng hoặc yêu cầu khách hàng bật lại 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. Để biết thêm thông tin, hãy xem bài viết Truy cập vào Bảng điều khiển dành cho quản trị viên của khách hàng.

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.

409:duplicate

Lỗi này xảy ra khi bạn đang cố gắng thêm một người dùng mới, nhưng email chính của khách hàng đã tồn tại trong một trong các trường hợp sau:

  • Tài khoản Google Workspace hiện tại mà bạn đang cố gắng thêm thẻ và vé.
  • Một sản phẩm khác của Google (không phải Google Workspace).

Để giải quyết vấn đề này, hãy làm như sau:

  1. Gọi phương thức users.get.

    Nếu bạn nhận được phản hồi 200, thì tức là người dùng đã tồn tại trong Tài khoản Google Workspace của khách hàng. Bạn không thể thêm người dùng này vào tài khoản.

    Nếu bạn nhận được phản hồi 403 forbidden, thì miền trong tham số email chính không phải là khách hàng bán lại hoặc email chính đã được sử dụng trước đó cho một sản phẩm khác của Google và trước tiên, bạn phải xác minh miền của khách hàng thì mới có thể thêm người dùng này thành công.

  2. Nếu bạn có thể xác minh miền của khách hàng, hãy làm như sau:

    1. Tạo người dùng quản trị tạm thời bằng phương thức users.insert và tiếp tục cấp phép cho bước xác minh miền cuối cùng.
    2. Khi xác minh miền, hãy thêm người dùng tạm thời vào tham số owners[] của phần nội dung yêu cầu cho lệnh gọi webResource.insert. Thực hiện lệnh gọi này cho đến khi bạn nhận được phản hồi 200.
    3. Sau khi xác minh miền, hãy đổi tên người dùng tạm thời bằng cách sử dụng phương thức users.patch hoặc users.update.

  3. Nếu bạn không thể xác minh miền của khách hàng, hãy làm như sau:

    1. Tạo người dùng quản trị tạm thời bằng phương thức users.insert.
    2. Yêu cầu khách hàng đăng nhập dưới vai trò người dùng tạm thời và xác minh miền của họ thông qua Bảng điều khiển dành cho quản trị viên.
    3. Sau khi miền được xác minh, khách hàng hoặc bạn có thể đổi tên tên người dùng tạm thời. Bạn có thể sử dụng phương thức users.patch hoặc users.update.

412:limitExceeded

Lỗi này xảy ra khi khách hàng của bạn đã đạt đến hạn mức chỗ ngồi tối đa. Để giải quyết vấn đề này, hãy sử dụng phương thức subscriptions.changeSeats và tuỳ thuộc vào gói thuê bao của họ, hãy sử dụng những thông tin sau:

  • Đối với FLEXIBLE, hãy tăng tham số maximumNumberOfSeats.
  • Đối với ANNUAL, hãy tăng tham số numberOfSeats.