Method: verificationCodes.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie l'ensemble actuel des codes de validation de secours valides pour l'utilisateur spécifié.
Requête HTTP
GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}/verificationCodes
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
userKey |
string
Identifie l'utilisateur dans la requête API. La valeur peut être l'adresse e-mail principale, l'adresse e-mail d'alias ou l'ID utilisateur unique de l'utilisateur.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Modèle de réponse JSON pour l'opération de liste des codes de validation dans l'API Directory.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
{
"kind": string,
"etag": string,
"items": [
{
object (VerificationCode )
}
]
} |
Champs |
kind |
string
Type de la ressource. Cette valeur est toujours admin#directory#verificationCodesList .
|
etag |
string
ETag de la ressource.
|
items[] |
object (VerificationCode )
Liste des ressources de code de validation.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/admin.directory.user.security
Pour en savoir plus, consultez le guide d'autorisation.
VerificationCode
L'API Directory vous permet d'afficher, de générer et d'invalider des codes de validation de secours pour un utilisateur.
Représentation JSON |
{
"userId": string,
"verificationCode": string,
"kind": string,
"etag": string
} |
Champs |
userId |
string
Identifiant unique brouillé de l'utilisateur.
|
verificationCode |
string
Code de validation actuel de l'utilisateur. Les codes de validation non validés ou utilisés ne sont pas renvoyés dans le résultat.
|
kind |
string
Type de la ressource. Cette valeur est toujours admin#directory#verificationCode .
|
etag |
string
ETag de la ressource.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]