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

詳しくは、認可ガイドをご覧ください。