Gmail API の概要

Gmail API は RESTful API で、Gmail メールボックスにアクセスしてメールを送信できます。ほとんどのウェブ アプリケーションでは、Gmail API はユーザーの Gmail データへの承認済みアクセスに最適な選択肢であり、次のようなさまざまなアプリケーションに適しています。

  • メールの読み取り専用抽出、インデックス作成、バックアップ
  • 自動またはプログラムによるメッセージの送信
  • メールアカウントの移行
  • メッセージのフィルタリングや並べ替えなどのメールの整理
  • 組織全体でのメール署名の標準化

よく使用する用語

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