排查 Directory API 问题

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

400:badRequest

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

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

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

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

403:domainCannotUseApis

如果客户已停用经销商对 Admin SDK API 的访问权限,则会发生此错误。如需解决此问题,请让客户重新启用对 Admin SDK API 的访问权限。如需了解详情,请参阅控制 API 访问权限

如果您尝试获取当前许可用户的数量,但收到此错误,请使用订阅资源中的 licensedNumberOfSeats 字段,而不是调用 users.list 方法。

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. 验证网域时,请将临时用户添加到 webResource.insert 调用的请求正文的 owners[] 参数中。 重复此调用,直到收到 200 响应。
    3. 验证网域后,使用 users.patchusers.update 方法重命名临时用户名。
  3. 如果您无法验证客户的网域,请执行以下操作:

    1. 使用 users.insert 方法创建临时管理员用户。
    2. 让客户以临时用户身份登录,并通过管理控制台验证其网域。
    3. 网域验证完毕后,客户或您可以重命名临时用户名。您可以使用 users.patchusers.update 方法。

412:limitExceeded

当客户达到其席位上限时,系统会显示此错误。如需解决此问题,请使用 subscriptions.changeSeats 方法,并根据用户的订阅方案使用以下方法:

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