Method: users.settings.sendAs.update
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
更新「以身分寄送」別名。如果提供簽名,Gmail 會先清理 HTML,再將其與別名一併儲存。
除了帳戶的主要地址外,其他地址只能由已委派全網域權限的服務帳戶用戶端更新。
HTTP 要求
PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
userId |
string
使用者的電子郵件地址。特殊值「me」可用來表示已驗證的使用者。
|
sendAsEmail |
string
要更新的傳送別名。
|
回應主體
如果成功,回應主體會包含 SendAs
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/gmail.settings.basic
https://www.googleapis.com/auth/gmail.settings.sharing
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# Method: users.settings.sendAs.update\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a send-as alias. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias.\n\nAddresses other than the primary address for the account can only be updated by service account clients that have been delegated domain-wide authority.\n\n### HTTP request\n\n`PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------------------------------------------------------|\n| `userId` | `string` User's email address. The special value \"me\" can be used to indicate the authenticated user. |\n| `sendAsEmail` | `string` The send-as alias to be updated. |\n\n### Request body\n\nThe request body contains an instance of [SendAs](/workspace/gmail/api/reference/rest/v1/users.settings.sendAs#SendAs).\n\n### Response body\n\nIf successful, the response body contains an instance of [SendAs](/workspace/gmail/api/reference/rest/v1/users.settings.sendAs#SendAs).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/gmail.settings.basic`\n- `\n https://www.googleapis.com/auth/gmail.settings.sharing`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]