Gmail API は、Gmail のメールボックスへのアクセスとメールの送信に使用できる RESTful API です。ほとんどのウェブ アプリケーションでは、Gmail API がユーザーの Gmail データへの承認済みのアクセスに最適です。次のようなさまざまなアプリケーションに適しています。
- 読み取り専用のメールの抽出、インデックス登録、バックアップ
- 自動またはプログラムによるメッセージ送信
- メール アカウントの移行
- メールのフィルタリングや並べ替えなど、メールを整理する
- 組織全体でメールの署名を標準化
Gmail API で使用される一般的な用語は次のとおりです。
- メッセージ
- 送信者、受信者、件名、本文を含むメール メッセージ。メッセージの作成後は変更できません。メッセージはメッセージ リソースで表されます。
- スレッド
- 会話を構成する関連メッセージのコレクション。メール クライアント アプリでは、1 人以上の受信者がメッセージに返信するとスレッドが形成されます。
- ラベル
メッセージとスレッドを整理するためのメカニズム。たとえば、「taxes」というラベルが作成され、ユーザーの税金に関するすべてのメッセージとスレッドに適用されます。ラベルには次の 2 種類があります。
- システムラベル
- 内部で作成されたラベル(
INBOX
、TRASH
、SPAM
など)。これらのラベルの削除や変更はできません。ただし、INBOX
などの一部のシステムラベルは、メッセージやスレッドに適用したり、削除したりできます。 - ユーザーラベル
- ユーザーが作成したラベル。これらのラベルは、ユーザーまたはアプリケーションが削除または変更できます。ユーザーラベルは、ラベルリソースで表されます。
- Draft
未送信のメッセージです。下書きに含まれるメッセージは置き換えることができます。 下書きを送信すると、下書きが自動的に削除され、
SENT
システムラベルが付いたメッセージが作成されます。ドラフトは、ドラフト リソースで表されます。
次のステップ
認証や認可の処理など、Google Workspace API を使用した開発については、Google Workspace デベロッパーとしてスタートガイドをご覧ください。
シンプルな Gmail API アプリを構成して実行する方法については、クイックスタートの概要をご覧ください。