Method: verificationCodes.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Gibt die aktuellen gültigen Back-up-Codes für den angegebenen Nutzer zurück.
HTTP-Anfrage
GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}/verificationCodes
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
userKey |
string
Identifiziert den Nutzer in der API-Anfrage. Der Wert kann die primäre E-Mail-Adresse, die Alias-E-Mail-Adresse oder die eindeutige Nutzer-ID des Nutzers sein.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
JSON-Antwortvorlage für den Vorgang „Bestätigungscodes auflisten“ in der Directory API.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"kind": string,
"etag": string,
"items": [
{
object (VerificationCode )
}
]
} |
Felder |
kind |
string
Der Typ der Ressource Dies ist immer admin#directory#verificationCodesList .
|
etag |
string
ETag der Ressource.
|
items[] |
object (VerificationCode )
Eine Liste von Ressourcen für Bestätigungscodes.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/admin.directory.user.security
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
VerificationCode
Mit der Directory API können Sie Back-up-Bestätigungscodes für einen Nutzer ansehen, generieren und ungültig machen.
JSON-Darstellung |
{
"userId": string,
"verificationCode": string,
"kind": string,
"etag": string
} |
Felder |
userId |
string
Die verschleierte eindeutige ID des Nutzers.
|
verificationCode |
string
Einen aktuellen Bestätigungscode für den Nutzer. Ungültige oder verwendete Bestätigungscodes werden nicht im Ergebnis zurückgegeben.
|
kind |
string
Der Typ der Ressource Dies ist immer admin#directory#verificationCode .
|
etag |
string
ETag der Ressource.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],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. |"]]