Method: users.settings.forwardingAddresses.create
Crea un indirizzo di inoltro. Se è richiesta la verifica della proprietà, verrà inviato un messaggio al destinatario e lo stato di verifica della risorsa verrà impostato su pending
; in caso contrario, la risorsa verrà creata con lo stato di verifica impostato su accepted
.
Questo metodo è disponibile solo per i client degli account di servizio a cui è stata delegata un'autorità a livello di dominio.
Richiesta HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
userId |
string
L'indirizzo email dell'utente. Il valore speciale "me" può essere utilizzato per indicare l'utente autenticato.
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di ForwardingAddress
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di ForwardingAddress
appena creata.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/gmail.settings.sharing
Per ulteriori informazioni, consulta la Guida alle autorizzazioni.
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 2024-09-05 UTC.
[null,null,["Ultimo aggiornamento 2024-09-05 UTC."],[[["Creates a forwarding address for a Gmail user, requiring domain-wide delegated authority for service accounts."],["If ownership verification is needed, a verification message is sent, setting the status to `pending`; otherwise, the status is set to `accepted`."],["Uses the `POST` method and provides details on the request body, response body, path parameters, and required authorization scope."],["This feature utilizes the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope for access and management of forwarding addresses."]]],["A forwarding address is created using a `POST` request to the specified URL, including the user's email in the `userId` path parameter. The request body must contain a `ForwardingAddress` instance. Ownership verification might be initiated, setting the status to `pending`. The operation is limited to service accounts with domain-wide authority, requiring the `gmail.settings.sharing` OAuth scope. Successful creation returns a new `ForwardingAddress` instance in the response body.\n"]]