---
title: Gmail
description: Gmailメッセージの送信、読み取り、検索、移動、またはGmailイベントからワークフローをトリガーする
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="gmail"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Gmail](https://gmail.com)はGoogleの人気メールサービスで、メールの送受信や管理のための堅牢なプラットフォームを提供しています。世界中で18億人以上のアクティブユーザーを持つGmailは、強力な検索機能、整理ツール、統合オプションを備えた機能豊富な体験を提供します。

Gmailでは以下のことができます：

- **メールの送受信**：クリーンで直感的なインターフェースを通じて連絡先とコミュニケーション
- **メッセージの整理**：ラベル、フォルダ、フィルターを使用して受信トレイを整理
- **効率的な検索**：Googleの強力な検索技術で特定のメッセージをすばやく見つける
- **ワークフローの自動化**：フィルターとルールを作成して受信メールを自動的に処理
- **どこからでもアクセス**：同期されたコンテンツと設定で複数のデバイスからGmailを使用
- **他のサービスとの統合**：GoogleカレンダーやDriveなどの生産性ツールと連携

Simでは、Gmail統合により、エージェントがプログラムによってメールを完全に管理し、包括的な自動化機能を利用できます。これにより、通知の送信、受信メッセージの処理、メールからの情報抽出、大規模なコミュニケーションワークフローの管理など、強力な自動化シナリオが可能になります。エージェントは以下のことができます：

- **作成と送信**: 添付ファイル付きのパーソナライズされたメールを作成し、受信者に送信
- **読み取りと検索**: Gmailのクエリ構文を使用して特定のメッセージを見つけ、コンテンツを抽出
- **インテリジェントな整理**: メッセージを既読/未読としてマーク、メールのアーカイブ/アーカイブ解除、ラベルの管理
- **受信トレイのクリーンアップ**: メッセージの削除、ラベル間のメール移動、受信トレイゼロの維持
- **ワークフローのトリガー**: 新しいメールをリアルタイムで監視し、受信メッセージに反応する応答性の高いワークフローを実現

この統合により、AIワークフローとメールコミュニケーションの間のギャップが埋められ、世界で最も広く使用されているコミュニケーションプラットフォームの一つとシームレスに連携できます。カスタマーサポートの自動応答、領収書の処理、サブスクリプションの管理、チームコミュニケーションの調整など、Gmail統合は包括的なメール自動化に必要なすべてのツールを提供します。
{/* MANUAL-CONTENT-END */}

## 使用手順

Gmailをワークフローに統合します。メールの送信、読み取り、検索、移動ができます。新しいメールを受信したときにワークフローをトリガーするトリガーモードでも使用できます。

## ツール

### Gmailで送信

Gmailを使用してメールを送信する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `to` | string | はい | 受信者のメールアドレス |
| `subject` | string | いいえ | メールの件名 |
| `body` | string | はい | メール本文の内容 |
| `contentType` | string | いいえ | メール本文のコンテンツタイプ（テキストまたはHTML） |
| `threadId` | string | いいえ | 返信するスレッドID（スレッド化用） |
| `replyToMessageId` | string | いいえ | 返信するGmailメッセージID - Gmail読み取り結果の「id」フィールドを使用（RFC「messageId」ではない） |
| `cc` | string | いいえ | CCの受信者（カンマ区切り） |
| `bcc` | string | いいえ | BCCの受信者（カンマ区切り） |
| `attachments` | file[] | いいえ | メールに添付するファイル |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | メールのメタデータ |

### `gmail_draft`

Gmailでメールの下書きを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `to` | string | はい | 受信者のメールアドレス |
| `subject` | string | いいえ | メールの件名 |
| `body` | string | はい | メール本文の内容 |
| `contentType` | string | いいえ | メール本文のコンテンツタイプ（テキストまたはHTML） |
| `threadId` | string | いいえ | 返信するスレッドID（スレッド化用） |
| `replyToMessageId` | string | いいえ | 返信するGmailメッセージID - Gmail読み取り結果の「id」フィールドを使用（RFC「messageId」ではない） |
| `cc` | string | いいえ | CCの受信者（カンマ区切り） |
| `bcc` | string | いいえ | BCCの受信者（カンマ区切り） |
| `attachments` | file[] | いいえ | メールの下書きに添付するファイル |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | 下書きのメタデータ |

### `gmail_read`

Gmailからメールを読み取る

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | いいえ | 読み取るメッセージのID |
| `folder` | string | いいえ | メールを読み取るフォルダ/ラベル |
| `unreadOnly` | boolean | いいえ | 未読メッセージのみを取得する |
| `maxResults` | number | いいえ | 取得するメッセージの最大数（デフォルト：1、最大：10） |
| `includeAttachments` | boolean | いいえ | メールの添付ファイルをダウンロードして含める |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | メールのテキスト内容 |
| `metadata` | json | メールのメタデータ |
| `attachments` | file[] | メールの添付ファイル |

### `gmail_search`

Gmailでメールを検索する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `query` | string | はい | メール検索クエリ |
| `maxResults` | number | いいえ | 返す結果の最大数 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 検索結果の概要 |
| `metadata` | object | 検索メタデータ |

### `gmail_move`

Gmailラベル/フォルダ間でメールを移動する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | はい | 移動するメッセージのID |
| `addLabelIds` | string | はい | 追加するラベルIDのカンマ区切りリスト（例：INBOX, Label_123） |
| `removeLabelIds` | string | いいえ | 削除するラベルIDのカンマ区切りリスト（例：INBOX, SPAM） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | メールメタデータ |

### `gmail_mark_read`

Gmailメッセージを既読としてマークする

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | はい | 既読としてマークするメッセージのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | メールのメタデータ |

### `gmail_mark_unread`

Gmailメッセージを未読にする

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | はい | 未読にするメッセージのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | メールのメタデータ |

### `gmail_archive`

Gmailメッセージをアーカイブする（受信トレイから削除）

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | はい | アーカイブするメッセージのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | メールのメタデータ |

### `gmail_unarchive`

Gmailメッセージをアーカイブ解除する（受信トレイに戻す）

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | はい | アーカイブ解除するメッセージのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | メールのメタデータ |

### `gmail_delete`

Gmailメッセージを削除する（ゴミ箱に移動）

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | はい | 削除するメッセージのID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | メールのメタデータ |

### `gmail_add_label`

Gmailメッセージにラベルを追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | はい | ラベルを追加するメッセージのID |
| `labelIds` | string | はい | 追加するラベルIDをカンマ区切りで指定（例：INBOX, Label_123） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | メールのメタデータ |

### `gmail_remove_label`

Gmailメッセージからラベルを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | はい | ラベルを削除するメッセージのID |
| `labelIds` | string | はい | 削除するラベルIDをカンマ区切りで指定（例：INBOX, Label_123） |

#### 出力
