確認メールを送信せずに、確認ステータスが accepted に直接設定された委任者を追加します。代理ユーザーは、委任ユーザーと同じ Google Workspace 組織のメンバーである必要があります。
Gmail では、Google Workspace 組織の各ユーザーが設定できる代理人と委任者の数に制限が設けられています。これらの上限は組織によって異なりますが、一般的に、各ユーザーは最大 25 人の代理人と最大 10 人の委任者を設定できます。
委任ユーザーは、メール エイリアスではなく、メインのメールアドレスで参照する必要があります。
また、新しい代理人を追加した場合、その代理人が使用可能になるまでに 1 分ほどかかることがあります。
このメソッドは、ドメイン全体の権限が委任されたサービス アカウント クライアントでのみ使用できます。
HTTP リクエスト
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ | |
|---|---|
userId |
ユーザーのメールアドレス。特別な値「me」を使用して、認証済みユーザーを示すことができます。 |
リクエストの本文
リクエストの本文には Delegate のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Delegate のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/gmail.settings.sharing
詳細については、OAuth 2.0 Overview をご覧ください。