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 アプリを構成して実行する方法については、クイックスタートをご覧ください。