Method: users.settings.forwardingAddresses.create
Создает адрес пересылки. Если требуется проверка права собственности, получателю будет отправлено сообщение, а статус проверки ресурса будет установлен на pending
; в противном случае ресурс будет создан со статусом проверки accepted
.
Этот метод доступен только для клиентов учетной записи службы, которым были делегированы полномочия на уровне домена.
HTTP-запрос
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
userId | string Адрес электронной почты пользователя. Специальное значение «я» может использоваться для обозначения аутентифицированного пользователя. |
Тело запроса
Тело запроса содержит экземпляр ForwardingAddress
.
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр ForwardingAddress
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/gmail.settings.sharing
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-09-05 UTC.
[null,null,["Последнее обновление: 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"]]