Gmail API は、Gmail メールボックスにアクセスしてメールを送信するために使用できる RESTful API です。ほとんどのウェブ アプリケーションでは、ユーザーの Gmail データへの認可されたアクセスに Gmail API を使用するのが最適です。Gmail API は、次のようなさまざまなアプリケーションに適しています。
- メールの読み取り専用抽出、インデックス登録、バックアップ
- 自動またはプログラムによるメッセージの送信
- メールアカウントの移行
- メールの整理（メッセージのフィルタリングや並べ替えなど）
- 組織全体でメールの署名を標準化する
よく使用する用語
この API で使用される一般的な用語を以下に示します。
- 委任者と代理人
- 委任者は、同じ Google Workspace 組織内の別のユーザーにメールボックスへのアクセス権を付与する Gmail ユーザーです。このアクセス権を受け取るユーザーは代理人です。代理人は、委任者のアカウントのメールの閲覧、送信、削除を行えるほか、連絡先の表示と追加も行えます。詳細については、委任を管理するをご覧ください。
- Draft
- 送信されていないメッセージ。下書きに含まれるメッセージは置き換えることができます。下書きを送信すると、下書きが自動的に削除され、
SENTシステムラベルが付いたメールが作成されます。下書きはdraftsリソースで表されます。詳細については、下書きを操作するをご覧ください。 - フィルタ
- 受信メッセージを特定の照合条件（送信者、件名、サイズなど）と照合するアカウント用に構成された高度なルール。メッセージが一致すると、フィルタによってラベルの追加や削除、指定したアドレスへのメールの転送などのアクションが自動的にトリガーされます。詳しくは、フィルタを管理するをご覧ください。
- 転送先アドレス
- ユーザーのアカウントから自動転送されたメッセージを受信するように構成された、特定の確認済みのメールアドレス。転送ルールやフィルタでアドレスを使用するには、その前にアドレスを正式に登録し、所有権を証明するために確認する必要があります。詳細については、転送を管理するをご覧ください。
- ラベル
メッセージとスレッドを整理するためのメカニズム。たとえば、「税金」というラベルを作成して、ユーザーの税金に関連するすべてのメッセージとスレッドに適用できます。詳細については、ラベルを管理するをご覧ください。
ラベルには次の 2 つの種類があります。
- システムラベル
- 内部で作成されたラベル（
INBOX、TRASH、SPAMなど）。これらのラベルは削除または変更できません。ただし、INBOXなどの一部のシステムラベルは、メールやスレッドに適用したり、メールやスレッドから削除したりできます。 - ユーザーラベル
- ユーザーが作成したラベル。これらのラベルは、ユーザーまたはアプリケーションによって削除または変更できます。ユーザーラベルは
labelsリソースで表されます。
- メッセージ
送信者、宛先、件名、本文を含むメール メッセージ。メッセージを作成した後は変更できません。メッセージは
messagesリソースで表されます。- プッシュ通知
Google Cloud Pub/Sub と統合されたサーバーサイドの通知システム。アプリケーションはメールボックスを「監視」できます。Gmail API は、変更（新しいメールの到着など）が発生するたびに自動的にウェブフックまたはアラートを送信するため、アプリがサーバーを継続的にポーリングして更新を確認する必要がなくなります。詳しくは、プッシュ通知をご覧ください。
- S/MIME 証明書
特定の「送信元」エイリアスにアップロードされたデジタル証明書。ユーザーは、暗号化されたメールやデジタル署名されたメールを送信できるようになり、メッセージのセキュリティと送信者の信頼性が確保されます。詳しくは、S/MIME 証明書を管理するをご覧ください。
- 送信専用エイリアス
これらは、アカウントがメールの送信を許可されているさまざまなメールアドレスを表します。すべてのアカウントには、メインのメールアドレスを表すエイリアスが少なくとも 1 つあります。エイリアスは Gmail ウェブ インターフェースの [名前] 機能に対応しており、アドレスごとのメール署名を設定する際の基準にもなります。詳細については、エイリアスを管理するをご覧ください。
- スレッド
会話を構成する関連メッセージのコレクション。メール クライアント アプリでは、1 人以上の受信者がメッセージに返信すると、スレッドが形成されます。詳しくは、スレッドを管理するをご覧ください。
関連トピック
認証と認可の処理など、Google Workspace API を使用した開発の詳細については、Google Workspace での開発をご覧ください。
Gmail API アプリを構成して実行する方法については、クイックスタートをご覧ください。