REST Resource: users.settings.delegates
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
リソース: 委任
デリゲートの設定。代理人は、委任者のアカウントのメールの閲覧、送信、削除、連絡先の表示と追加を行えます。委任者の詳細については、「メール委任を設定する」をご覧ください。
フィールド |
delegateEmail |
string
委任者のメールアドレス。
|
verificationStatus |
enum (VerificationStatus )
この住所が確認済みで、アカウントの委任者として機能できるかどうかを示します。読み取り専用です。
|
VerificationStatus
委任使用のためにメールアドレスの所有権が確認されているかどうかを示します。
列挙型 |
verificationStatusUnspecified |
未指定の確認ステータス。 |
accepted |
この住所は、アカウントの代理人として機能します。 |
pending |
確認リクエストが住所宛てに郵送されましたが、所有者がまだ承認していません。 |
rejected |
住所宛てに確認リクエストが郵送されましたが、所有者が拒否しました。 |
expired |
身元確認リクエストが住所宛てに郵送されましたが、確認されずに有効期限が切れました。 |
メソッド |
|
確認メールを送信せずに、確認ステータスを accepted に直接設定した委任者を追加します。 |
|
指定した委任者(確認ステータスは問いません)を削除し、その使用に必要だった確認をすべて取り消します。 |
|
指定されたデリゲートを取得します。 |
|
指定したアカウントの代理人を一覧表示します。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# REST Resource: users.settings.delegates\n\n- [Resource: Delegate](#Delegate)\n - [JSON representation](#Delegate.SCHEMA_REPRESENTATION)\n- [VerificationStatus](#VerificationStatus)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Delegate\n------------------\n\nSettings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See [\"Set up mail delegation\"](https://support.google.com/mail/answer/138350) for more information about delegates.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"delegateEmail\": string, \"verificationStatus\": enum (/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus) } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `delegateEmail` | `string` The email address of the delegate. |\n| `verificationStatus` | `enum (`[VerificationStatus](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus)`)` Indicates whether this address has been verified and can act as a delegate for the account. Read-only. |\n\nVerificationStatus\n------------------\n\nIndicates whether ownership of an email address has been verified for delegation use.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------------------------------|\n| `verificationStatusUnspecified` | Unspecified verification status. |\n| `accepted` | The address can act a delegate for the account. |\n| `pending` | A verification request was mailed to the address, and the owner has not yet accepted it. |\n| `rejected` | A verification request was mailed to the address, and the owner rejected it. |\n| `expired` | A verification request was mailed to the address, and it expired without verification. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### [create](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/create) | Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. |\n| ### [delete](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/delete) | Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. |\n| ### [get](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/get) | Gets the specified delegate. |\n| ### [list](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/list) | Lists the delegates for the specified account. |"]]