排查 Directory API 问题

本页面介绍您作为转销商在使用 Directory API 时可能会遇到的一些常见问题。

400:badRequest

当向方法传递了不正确的参数值时，就会出现此错误。

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

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

  • customer 形参：仅使用 customerId，该 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 响应，则表示主 电子邮件地址形参中的网域不是转售客户，或者主电子邮件地址之前已用于其他 Google 产品，并且必须先验证客户的网域，然后才能成功添加此用户。

  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 形参。