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

詳細については、OAuth 2.0 Overview をご覧ください。