Method: users.settings.forwardingAddresses.create
Cria um endereço de encaminhamento. Se a verificação de propriedade for necessária, uma mensagem será enviada ao destinatário e o status de verificação do recurso será definido como pending. Caso contrário, o recurso será criado com o status de verificação definido como accepted.
Esse método só está disponível para clientes de conta de serviço com autoridade em todo o domínio delegada.
Solicitação HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
userId |
string
Endereço de e-mail do usuário. O valor especial "me" pode ser usado para indicar o usuário autenticado.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de ForwardingAddress.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de ForwardingAddress.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/gmail.settings.sharing
Para mais informações, consulte o Guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-05 UTC.
[null,null,["Última atualização 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"]]
