このドキュメントでは、Gmail API でメール転送を構成する方法について説明します。
settings リソースを使用して、アカウントの転送を構成できます。転送にメールアドレスを使用するには、次のいずれかの条件を満たしている必要があります。
- メールアドレスが確認済みである。詳しくは、転送用アドレスを作成、確認するをご覧ください。
- メールアドレスが送信者と同じドメインに属している。
- メールアドレスが、送信者と同じドメイン内のサブドメインに属している。
- メールアドレスは、同じ Google Workspace アカウントの一部として構成されたドメイン エイリアスに属しています。
転送用メールアドレスがこれらのルールのいずれかに準拠していない場合、API を使用した転送の設定は失敗します。
転送先アドレスの作成、一覧表示、取得、削除の方法については、settings.forwardingAddresses リソースのメソッドをご覧ください。
自動転送設定を取得または更新する方法については、settings リソースのメソッドをご覧ください。
転送先アドレスを作成して確認する
転送アドレスは、使用する前に作成する必要があります。場合によっては、ユーザーが住所の所有権を確認する必要もあります。
Gmail で転送先アドレスのユーザー確認が必要な場合、API は VerificationStatus が pending のアドレスを返します。Gmail は、対象のメールアドレスに確認メッセージを自動的に送信します。メールアドレスを使用するには、その所有者が確認プロセスを完了する必要があります。
確認を必要としない転送先アドレスの確認ステータスは accepted です。
自動転送を有効にする
Gmail の新着メールをすべて他のメールアドレスに転送できます。
これを行うには、updateAutoForwarding メソッドを呼び出して、アカウントの自動転送を有効にします。この呼び出しには、登録および確認済みの転送先アドレスと、転送されたメッセージに対して行うアクションが必要です。これらの値は AutoForwarding オブジェクトで設定します。
disposition フィールドを使用して、メッセージ転送後のメッセージの状態を設定します。デフォルト値は dispositionUnspecified ですが、このフィールドを dispositionUnspecified に設定することはできません。
次のコードサンプルは、自動転送を有効にしてから、転送されたメッセージをゴミ箱に移動する方法を示しています。
Java
Python
自動転送を無効にするには、updateAutoForwarding メソッドを呼び出し、AutoForwarding オブジェクトの enabled フィールドを false に設定します。
特定のメッセージを転送する
自動転送では、受信した Gmail のメールがすべて転送先アカウントに送信されます。特定のメールを転送するには、フィルタを設定して、メールの属性や内容に応じてメールを転送するルールを作成します。
メールを複数のアカウントに転送するには、転送先のメールアドレスごとにフィルタを作成します。