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

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 Directory API với tư cách là đại lý.

400:badRequest

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

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

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 được tạo bởi Google. Không sử dụng miền của khách hàng thực tế. Chúng tôi khuyên bạn nên sử dụng vì nếu khách hàng có miền phụ, thì việc sử dụng domain 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 của khách hàng thực tế. 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 đã vô hiệu hoá quyền truy cập của người bán lại 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 của bạn 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 Kiểm soát quyền truy cập API.

Nếu bạn đang tìm cách tính số người dùng hiện được cấp phép và nhận được thông báo này lỗi, thay vì gọi phương thức users.list, hãy 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 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ọ.

Để giải quyết vấn đề này, hãy gọi Phương thức customers.get trước khi 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 muốn 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 của họ. Để biết thêm thông tin, xem 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 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.

409:duplicate

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

  • Tài khoản Google Workspace hiện tại mà bạn đang cố gắng thêm các thành phần đó.
  • 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 này đã tồn tại trong Tài khoản Google Workspace. 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 thông số email không phải là khách hàng được bán lại hoặc email chính đã được sử dụng cho một sản phẩm khác của Google và miền của khách hàng phải đầu tiên phải được xác minh trước khi có thể thêm thành công người dùng này.

  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 owners[] của phần nội dung yêu cầu webResource.insert cuộc gọi. Hãy thực hiện cuộc gọi này cho đến khi bạn nhận được phản hồi 200.
    3. Sau khi miền được xác minh, hãy đổi tên tên người dùng tạm thời bằng cách sử dụng hoặ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 của bạn đăng nhập với tư cách là người dùng tạm thời và xác minh 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 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 giới hạn giấy phép tối đa. Người nhận 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 cách sau:

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