Method: verificationCodes.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}/verificationCodes
网址采用 gRPC 转码语法。
路径参数
参数 |
userKey |
string
用于在 API 请求中标识用户。该值可以是用户的主电子邮件地址、别名电子邮件地址或唯一用户 ID。
|
响应正文
Directory API 中列出验证码操作的 JSON 响应模板。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"kind": string,
"etag": string,
"items": [
{
object (VerificationCode )
}
]
} |
字段 |
kind |
string
资源的类型。此值始终为 admin#directory#verificationCodesList 。
|
etag |
string
资源的 ETag。
|
items[] |
object (VerificationCode )
验证码资源的列表。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/admin.directory.user.security
如需了解详情,请参阅授权指南。
VerificationCode
借助 Directory API,您可以查看、生成和使用户的备用验证码失效。
JSON 表示法 |
{
"userId": string,
"verificationCode": string,
"kind": string,
"etag": string
} |
字段 |
userId |
string
用户经过模糊处理的唯一 ID。
|
verificationCode |
string
用户的当前验证码。已失效或已使用的验证码不会作为结果返回。
|
kind |
string
资源的类型。此值始终为 admin#directory#verificationCode 。
|
etag |
string
资源的 ETag。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Method: verificationCodes.list\n\nReturns the current set of valid backup verification codes for the specified user.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}/verificationCodes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| `userKey` | `string` Identifies the user in the API request. The value can be the user's primary email address, alias email address, or unique user ID. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nJSON response template for list verification codes operation in Directory API.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"items\": [ { object (/workspace/admin/directory/reference/rest/v1/verificationCodes/list#VerificationCode) } ] } ``` |\n\n| Fields ||\n|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the resource. This is always `admin#directory#verificationCodesList`. |\n| `etag` | `string` ETag of the resource. |\n| `items[]` | `object (`[VerificationCode](/workspace/admin/directory/reference/rest/v1/verificationCodes/list#VerificationCode)`)` A list of verification code resources. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.user.security`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nVerificationCode\n----------------\n\nThe Directory API allows you to view, generate, and invalidate backup verification codes for a user.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------|\n| ``` { \"userId\": string, \"verificationCode\": string, \"kind\": string, \"etag\": string } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `userId` | `string` The obfuscated unique ID of the user. |\n| `verificationCode` | `string` A current verification code for the user. Invalidated or used verification codes are not returned as part of the result. |\n| `kind` | `string` The type of the resource. This is always `admin#directory#verificationCode`. |\n| `etag` | `string` ETag of the resource. |"]]