本页面介绍了您作为转销商在使用 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 访问权限。
如果您在尝试获取当前获得许可的用户数时遇到此错误,请不要调用 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)。
如需解决此问题,请执行以下操作:
调用
users.get
方法。如果您收到
200
响应,则表示客户的 Google Workspace 账号中已存在该用户。无法将此用户添加到该账号。如果您收到
403 forbidden
响应,则表示主电子邮件地址参数中的网域不是转销商的客户,或者主电子邮件地址之前已用于其他 Google 产品,您必须先验证客户的网域,然后才能成功添加此用户。如果您能验证客户的域名,请执行以下操作:
- 使用
users.insert
方法创建临时管理员用户,并继续预配到最终的网域验证步骤。 - 验证网域时,将临时用户添加到
webResource.insert
调用的请求正文的owners[]
参数中。发出此呼叫,直到收到200
响应。 - 验证网域后,使用
users.patch
或users.update
方法重命名临时用户名。
- 使用
如果您无法验证客户的域名,请执行以下操作:
- 使用
users.insert
方法创建临时管理员用户。 - 让您的客户以临时用户身份登录,并通过管理控制台验证其网域。
- 验证网域后,客户或您可以重命名临时用户名。您可以使用
users.patch
或users.update
方法。
- 使用
412:limitExceeded
当您的客户达到席位上限时,就会出现此错误。如需解决此问题,请使用 subscriptions.changeSeats
方法,并根据其订阅方案使用以下方法:
- 对于
FLEXIBLE
,请增加maximumNumberOfSeats
参数。 - 对于
ANNUAL
,请增加numberOfSeats
参数。