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 liên quan đến Directory API khi là một đại lý.

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 thay thế hoặc mã nhận dạng người dùng duy nhất của người dùng.

Nếu bạn sử dụng phương thức users.list, hãy xác minh các tham 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 chỉ 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. Đừ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 đạ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 bài viết 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 tại 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 trong 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 đã 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ọ.

Để 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 của họ. Để 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 rồi bật API. Để biết thêm thông tin, hãy xem bài viết 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 những trường hợp sau:

  • Tài khoản Google Workspace hiện tại mà bạn đang cố gắng thêm họ vào.
  • 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ì 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 được bán lại hoặc email chính đã được dùng trước đây cho một sản phẩm khác của Google và miền của khách hàng phải được xác minh trước khi người dùng này có thể được thêm 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 một người dùng quản trị tạm thời bằng phương thức users.insert và tiếp tục cung cấp đến 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 nội dung yêu cầu cho lệnh gọi webResource.insert. 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 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 với tư cách là 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 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 giới hạn số lượng người dùng 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.