Method: users.settings.delegates.create

確認ステータスが直接 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

string

ユーザーのメールアドレス。特別な値「me」を使用して、認証済みユーザーを示すことができます。

リクエスト本文

リクエストの本文には Delegate のインスタンスが含まれています。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Delegate のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/gmail.settings.sharing

詳細については、承認ガイドをご覧ください。