排查 Directory API 问题

这一页介绍了您可能会遇到的一些涉及到 Directory API。

400:badRequest

如果向方法传递的参数值不正确，就会显示此错误。

如果使用 users.get 方法，请验证传入 userKey 的值是否 参数是用户的主电子邮件地址、别名电子邮件地址或 唯一用户 ID。

如果使用 users.list 方法，请验证以下参数：

  • customer 参数：仅使用customerId Google。请勿使用实际客户的网域。我们建议使用此 参数，因为如果客户有辅助网域，则使用 domain 参数仅返回电子邮件地址位于该特定网域的用户。
  • domain 参数：仅使用实际客户的域名。不使用
    由 Google 生成的 customerId。

403:domainCannotUseApis

当客户停用转销商对 Admin SDK API。要解决此问题，请让您的客户重新启用以下服务的访问权限： Admin SDK API。如需了解详情，请参阅 控制 API 访问权限。

如果您想获取当前获得许可的用户数， 错误，不要调用 users.list 方法，而应使用 licensedNumberOfSeats 字段 订阅资源

403:forbidden

如果您不是该客户的所有者或者您的客户已停用，就会出现此错误 转销商访问其管理控制台的权限。

要解决此问题，您可以调用 customers.get 方法 然后再致电以验证客户对转销商的所有权，或询问您的 客户可以重新启用转销商对其管理控制台的访问权限。有关 请参阅 访问客户的管理控制台。

403:usageLimits.accessNotConfigured

如果 Google Cloud 项目中未启用该 API，就会出现此错误。要解决 请前往 Google Cloud 控制台启用 API。有关 请参阅 启用 Google Workspace API。

409:duplicate

当您尝试添加新用户，但客户的 以下任一电子邮件地址中已存在主电子邮件地址：

  • 您正在尝试添加这些用户的当前 Google Workspace 账号。
  • 其他 Google 产品（非 Google Workspace）。

如需解决此问题，请执行以下操作：

  1. 调用 users.get 方法。

    如果您收到 200 响应，则表示该用户已存在于该客户的 Google Workspace 账号。您无法将此用户添加到该账号。

    如果您收到 403 forbidden 响应，则表示主域名中的域名 电子邮件参数不是转销商的客户，或者主电子邮件地址已被使用 且客户的网域必须 必须先通过验证，然后才能成功添加此用户。

  2. 如果您可以验证客户的域名，请执行以下操作：

    1. 使用 users.insert 方法 并继续配置到最后一个域名验证步骤。
    2. 验证域名时，请将临时用户添加到 owners[] 是 webResource.insert 调用。 请拨打此电话，直到收到 200 响应。
    3. 验证域名后，请使用 不是 users.patch 或 users.update 方法。

  3. 如果您无法验证客户的域名，请执行以下操作：

    1. 使用 users.insert 方法。
    2. 让您的客户以临时用户身份登录，并验证其 管理网域。
    3. 验证域名后，您可以为客户或重命名 临时用户名您可以使用 users.patch 或 users.update 方法。

412:limitExceeded

当客户达到席位上限时，就会出现此错误。接收者 请使用 subscriptions.changeSeats 方法 并根据他们的订阅方案使用以下选项：

  • 对于 FLEXIBLE，请增加 maximumNumberOfSeats 参数。
  • 对于 ANNUAL，请增加 numberOfSeats 参数。