Method: verificationCodes.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Restituisce l'insieme corrente di codici di verifica di backup validi per l'utente specificato.
Richiesta HTTP
GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}/verificationCodes
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
userKey |
string
Identifica l'utente nella richiesta API. Il valore può essere l'indirizzo email principale, l'indirizzo email alias o l'ID utente univoco dell'utente.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Modello di risposta JSON per l'operazione di codici di verifica dell'elenco nell'API Directory.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
{
"kind": string,
"etag": string,
"items": [
{
object (VerificationCode )
}
]
} |
Campi |
kind |
string
Il tipo di risorsa. Questo valore è sempre admin#directory#verificationCodesList .
|
etag |
string
ETag della risorsa.
|
items[] |
object (VerificationCode )
Un elenco di risorse per i codici di verifica.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/admin.directory.user.security
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
VerificationCode
L'API Directory consente di visualizzare, generare e invalidare i codici di verifica di backup per un utente.
Rappresentazione JSON |
{
"userId": string,
"verificationCode": string,
"kind": string,
"etag": string
} |
Campi |
userId |
string
L'ID univoco offuscato dell'utente.
|
verificationCode |
string
Un codice di verifica attuale per l'utente. I codici di verifica non validi o utilizzati non vengono restituiti come parte del risultato.
|
kind |
string
Il tipo di risorsa. Questo valore è sempre admin#directory#verificationCode .
|
etag |
string
ETag della risorsa.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]