代理人を管理する

このドキュメントでは、Gmail API を使用してメールの委任と共同編集を行う方法について説明します。

Gmail ユーザーは、同じ Google Workspace 組織内の 1 人以上のユーザーにメールボックスへのアクセス権を付与できます。アクセス権を付与するユーザーは委任者、アクセス権を受け取るユーザーは代理人です。

代理人は、アカウント内のメール メッセージを閲覧、送信、削除できます。連絡先の表示や追加もできます。代理人があなたのアカウントからメールを送信すると、代理人のメールアドレスが表示されます。詳しくは、メールを委任する、メールで共同作業するをご覧ください。

Google Workspace 組織は、settings.delegates リソースを使用して、組織内の Gmail アカウントの代理人を管理できます。これには、ドメイン全体の権限が委任されたサービス アカウントが必要です。

委任ユーザーは、メール エイリアスではなく、メインのメールアドレスで参照する必要があります。Gmail では、Google Workspace 組織のユーザーごとに設定できる代理人の数は最大 25 人に制限されています。

settings.delegates リソースには、デリゲートの作成、一覧表示、取得、削除の方法に関する詳細情報が含まれています。

settings.delegates リソースには、メールアドレスの所有権が委任用に確認されているかどうかを示す VerificationStatus オブジェクトが含まれています。settings.delegates.create メソッドを使用して委任を作成すると、確認メールを送信せずに verificationStatus フィールドが accepted に設定されます。