Gmail API は RESTful API で、Gmail メールボックスにアクセスしてメールを送信できます。ほとんどのウェブ アプリケーションでは、ユーザーの Gmail データへの承認済みアクセスに Gmail API を使用するのが最適です。次のようなさまざまなアプリケーションに適しています。
- メールの読み取り専用の抽出、インデックス作成、バックアップ
- 自動またはプログラムによるメッセージの送信
- メールアカウントの移行
- メッセージのフィルタリングと並べ替えを含むメールの整理
- 組織全体でのメール署名の標準化
よく使用する用語
この API で使用される一般的な用語を以下に示します。
- 委任者と代理人
- 委任者とは、同じ Google Workspace 組織内の別のユーザーにメールボックスへのアクセス権を付与する Gmail ユーザーです。このアクセス権を受け取るユーザーが代理人です。代理人は、委任者のアカウントのメールの閲覧、送信、削除を行えるほか、連絡先の表示と追加も行えます。詳細については、 代理人を管理するをご覧ください。
- 下書き
- 送信されていないメッセージ。下書きに含まれるメッセージは置き換えることができます。
下書きを送信すると、下書きが自動的に削除され、
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 アプリを構成して実行する方法については、 クイックスタートをご覧ください。