Method: users.settings.forwardingAddresses.create
Membuat alamat penerusan. Jika verifikasi kepemilikan diperlukan, pesan akan dikirim kepada penerima dan status verifikasi fasilitas akan ditetapkan ke pending
; jika tidak, fasilitas akan dibuat dengan status verifikasi yang ditetapkan ke accepted
.
Metode ini hanya tersedia untuk klien akun layanan yang telah didelegasikan ke otoritas seluruh domain.
Permintaan HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
userId |
string
Alamat email pengguna. Nilai khusus "me" dapat digunakan untuk menunjukkan pengguna yang diautentikasi.
|
Isi permintaan
Isi permintaan memuat instance ForwardingAddress
.
Isi respons
Jika berhasil, isi respons memuat instance ForwardingAddress
yang baru dibuat.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/gmail.settings.sharing
Untuk informasi selengkapnya, lihat Panduan otorisasi.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-09-05 UTC.
[null,null,["Terakhir diperbarui pada 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"]]