> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Agents で Google Drive を使用する
> Agent ノードで Google ドキュメント、Google スプレッドシート、Google スライドを読み書きする方法を説明します
[Google アカウントを接続](/ja-jp/integrations/google-drive/connect-google-drive-to-profound)すると、Profound の Agents で次のノードが利用できるようになります。これらのノードは、Agent Builder の **Google Suite** にある **Google Docs** グループと **Google Sheets** グループ、および **Google Slides** ノードにあります。
各ノードは、**Google Account** で選択した Google アカウントとして実行されます。アクセスできるのは、Google のファイルピッカーで追加したファイルと Profound が作成したファイルのみなので、ノードを使って構築する前に[ファイルを追加](/ja-jp/integrations/google-drive/connect-google-drive-to-profound#step-3)してください。
Agents を初めて使用する場合は、Profound ヘルプセンターの [Agents の使い方](https://help.tryprofound.com/articles/2212787792-create-an-agent)をご覧ください。
## 利用可能なノード
### Create Document
Google ドキュメントを作成します。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Document Title** — 新しいドキュメントのタイトル
#### 任意の入力
| 入力 | デフォルト | 説明 |
| - | - | - |
| **Content format** | **Plain Text** | **Initial Content** の読み取り方法です。**Plain Text**、**Markdown**、**HTML** から選択します。貼り付けたり参照したりするコンテンツの形式に合わせてください。 |
| **Initial Content** | - | 新しいドキュメントのコンテンツです。Markdown と HTML は Google によって書式付きテキストに変換されます。HTML には `...
` などのタグが含まれている必要があります。 |
| **Destination folder** | **My Drive** | ドキュメントを作成する Drive のフォルダです。ピッカーで追加したフォルダを選択するか、**Add a folder from Google Drive** を選択してフォルダを追加します。共有ドライブ内のフォルダも指定できます。フォルダ ID を保持する変数も使用できます。 |
#### 出力
新しいドキュメントの `documentId`、`document_url`、`title` を含む JSON オブジェクト。
フォルダ内に作成したばかりのドキュメントに Profound がコンテンツを書き込めなかった場合、フォルダに空のファイルがたまらないよう、その空のドキュメントはゴミ箱に移動されます。
### Get Document
Google ドキュメントのコンテンツを読み取ります。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Document** — 追加したドキュメントを検索して選択するか、ドキュメントの URL を貼り付けます。ドキュメント ID や前のノードの出力の変数も使用できます
#### 任意の入力
* **Export format** — **Plain text** (デフォルト)、**HTML**、**Markdown**、**Raw (Docs API JSON)** から選択します。Raw は、すべてのタブを含む Google のドキュメント JSON 全体を返します。
#### 出力
選択した形式のドキュメントコンテンツ (テキスト)。
エクスポートが 5 MB を超えるドキュメントは返されず、ノードはドキュメントが大きすぎることを報告します。
### Create Spreadsheet
スプレッドシートを作成して最初のシートに行を入力するか、既存のスプレッドシートに行を含む新しいシートを追加します。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Title** — 新しいスプレッドシートのタイトル、または既存のスプレッドシートに追加する場合は新しいシートのタイトル
* **Rows** — 書き込むデータ。**Input format** で選択した形式で指定します
* **Input format** — **CSV** (ノード追加時にデフォルトで選択)、**TSV (tab-separated)**、**Markdown table**、**HTML table**、**JSON** から選択します。JSON では、オブジェクトの配列 (キーがヘッダー行になります)、列をキーとする配列のオブジェクト、配列の配列を使用できます。コンテンツを囲むコードフェンスは解析前に削除されます
#### 任意の入力
| 入力 | デフォルト | 説明 |
| - | - | - |
| **Add to Existing Spreadsheet** | - | 新しいスプレッドシートを作成する場合は空のままにします。既存のスプレッドシートを選択するか URL を貼り付けると、代わりに **Title** という名前の新しいシートタブが追加されます。 |
| **Value input option** (詳細設定内) | **Formula / number (interpret as typed)** | 書き込まれた値を Google がどのように読み取るかを指定します。**Formula / number** では、数式や数値がセルに直接入力した場合と同様に解釈されます (例: `=SUM(A1:B1)`)。**Plain text (no parsing)** では、テキストとして保存されます。 |
#### 出力
新しいスプレッドシートの場合は、`spreadsheetId`、`spreadsheet_url`、`title` を含む JSON オブジェクト。新しいシートの場合は、`spreadsheetId`、`spreadsheet_url`、`sheetId`、`sheet_title` を含む JSON オブジェクト。
シート間でデータをコピーするには、**Input format** を [**Get Sheet Values**](#get-sheet-values) で使用した **Output format** に合わせます。CSV、TSV、HTML、Markdown、および JSON の各形式は、相互に変換しても元の形を保てます。
### Get Row
シートから 1 行を読み取ります。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Spreadsheet** — 追加したスプレッドシートを検索して選択するか、URL を貼り付けます
* **Row selection** — **Specific row**、**First row**、**Last row** から選択します
* **Row number** — **Row selection** が **Specific row** の場合に読み取る行です。スプレッドシートの行番号と一致します
#### 任意の入力
* **Sheet name** — 読み取るシートタブ。省略すると最初のシートが使用されます
#### 出力
`row_number`、`values` (セルの値を順番に並べたもの)、`record` を含む JSON オブジェクト。`record` は 1 行目のヘッダー名を行の値に対応付けたもので、読み取った行が 1 行目の場合やシートが空の場合は `null` になります。
### Get Sheet Values
セルの範囲を読み取ります。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Spreadsheet** — 追加したスプレッドシートを検索して選択するか、URL を貼り付けます
#### 任意の入力
| 入力 | デフォルト | 説明 |
| - | - | - |
| **Sheet name** | 最初のシート | 読み取るシートタブです。 |
| **Range** | シート全体 | シート内の A1 形式の範囲です (例: `A1:D10`)。 |
| **Value render option** (詳細設定内) | **Formatted value** | **Formatted value** は表示されているとおりの値を、**Unformatted value** は元の値を、**Formula** は結果ではなく数式を返します。 |
| **Output format** (詳細設定内) | **Rows (2D array)** | 出力の形式です。**Rows (2D array)**、**Records (list of dicts)**、**Columns (dict of lists)**、**CSV (string)**、**TSV (tab-separated)**、**HTML table**、**Markdown table**、**Raw (full API response)** から選択します。Records、Columns、CSV、TSV、HTML、Markdown では、範囲の 1 行目がヘッダーとして扱われます。 |
#### 出力
選択した形式のデータを `values` に含む JSON オブジェクト。**Raw** の場合は、代わりに `values` と `majorDimension` を含む Google のレスポンス全体が返されます。
**Records** と **Columns** では、ヘッダー名が一意である必要があります。2 つの列が同じ名前を共有している場合は、スプレッドシートでいずれかの名前を変更するか、別の形式を選択してください。
### Update Cell
1 つのセルに 1 つの値を書き込みます。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Spreadsheet** — 追加したスプレッドシートを検索して選択するか、URL を貼り付けます
* **Cell** — A1 形式のセル (例: `A1`)
* **Value** — 書き込む値。文字列、数値、またはブール値で指定します
#### 任意の入力
* **Sheet name** — 書き込むシートタブ。省略すると最初のシートが使用されます
* **Value input option** (詳細設定内) — **Formula / number (interpret as typed)** (デフォルト) または **Plain text (no parsing)**
#### 出力
更新された範囲を含む、Google の更新レスポンス。
### Write Row
シートに 1 行を追加するか、既存の 1 行を上書きします。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Spreadsheet** — 追加したスプレッドシートを検索して選択するか、URL を貼り付けます
* **Values** — 列に順番に対応するセル値の JSON 配列 (例: `["Alice", "alice@example.com", 42, true]`)
* **Write mode** — **Append to end** (デフォルト) は、データがある最後の行の後に行を追加します。**Overwrite specific row** は、**Row number** で指定した行を置き換えます
* **Row number** — **Write mode** が **Overwrite specific row** の場合に上書きする行
#### 任意の入力
* **Sheet name** — 書き込むシートタブ。省略すると最初のシートが使用されます
* **Value input option** (詳細設定内) — **Formula / number (interpret as typed)** (デフォルト) または **Plain text (no parsing)**
* **Start column** (詳細設定内) — 行を開始する列の文字 (例: `A` や `E`)。空の場合、追加時は Google が表の位置を検出し、上書き時は `A` 列から開始します
#### 出力
`updated_range` と書き込まれた `row_number` を含む JSON オブジェクト。
### Write Rows
1 回の実行で、シートに複数の行を追加するか、既存の複数の行を更新します。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Spreadsheet** — 追加したスプレッドシートを検索して選択するか、URL を貼り付けます
* **Mode** — **Add rows** (デフォルト) は、データがある最後の行の後に追加します。**Update rows** は、指定した行を上書きします
* **Row Data Format** — **Arrays** (デフォルト) または **JSON Objects**
* **Row Data** — 1 行につき 1 つのエントリを持つ JSON 配列。形式は **Mode** と **Row Data Format** によって異なります。
| Mode | Arrays | JSON Objects |
| - | - | - |
| **Add rows** | 内側の各配列が 1 行で、列に順番に対応します: `[["Alice", "alice@example.com", 90], ["Bob", "bob@example.com", 85]]` | キーは列の文字です: `[{"A": "Alice", "B": "alice@example.com", "C": 90}]` |
| **Update rows** | 各行の最初の要素が更新する行番号です: `[[1, "Alice", "alice@example.com", 95], [3, "Charlie", "charlie@example.com", 88]]` | 各オブジェクトに `row_number` キーを含めます: `[{"row_number": 1, "A": "Alice", "B": "alice@example.com"}]` |
#### 任意の入力
* **Sheet name** — 書き込むシートタブ。省略すると最初のシートが使用されます
* **Value input option** (詳細設定内) — **Formula / number (interpret as typed)** (デフォルト) または **Plain text (no parsing)**
* **Start column** (詳細設定内) — 行を開始する列の文字 (例: `A` や `E`)。空の場合、行の追加時は Google が表の位置を検出し、更新時は `A` 列から開始します
#### 出力
`rows_created`、`rows_updated`、`updated_range` を含む JSON オブジェクト。
### Google Slides
Google スライドのプレゼンテーションのテキストコンテンツを読み取ります。
#### 必須の入力
* **Google Account** — ドロップダウンから接続済みのアカウントを選択します
* **Presentation** — 追加したプレゼンテーションを検索して選択するか、URL を貼り付けます
#### 出力
プレゼンテーションのテキスト (プレーンテキスト)。
エクスポートが 5 MB を超えるプレゼンテーションは返されず、ノードはプレゼンテーションが最大サイズを超えていることを報告します。
***
## 主要な概念
### Profound がアクセスできるファイル
Profound は Google の `drive.file` 権限を保持しており、その対象は Google のファイルピッカーで選択したファイルと Profound が作成したファイルのみです。各ファイルドロップダウンには、選択したアカウントのこれらのファイルが一覧表示されます。ドロップダウンの下部にある **Add files from Google Drive** アクションを使用すると、ピッカーが開き、ファイルを追加できます。
Profound が **Create Document** と **Create Spreadsheet** で作成したファイルは、追加しなくても後続のノードで利用できます。
### ファイルの選択
**Document**、**Spreadsheet**、**Presentation** の入力には、次のものを指定できます。
* ドロップダウンから選択したファイル
* ファイルの URL (例: `https://docs.google.com/document/d//edit` や `https://drive.google.com/open?id=`)
* ファイルの ID
* 前のノードの出力の変数 (例: **Create Document** が返す `documentId`)
値が ID でも URL でもない場合、Profound はそれをファイル名として扱い、アクセスできるファイルの中から大文字と小文字を区別せずに完全一致するものを探します。一致するファイルがない場合や、複数のファイルが一致する場合、ノードはエラーで停止します。その場合は ID または URL を使用してください。
### シート、範囲、値
* **Sheet name** は、スプレッドシート内のタブの名前です。最初のタブを使用する場合は空のままにします。
* **Range** と **Cell** には A1 形式を使用します (例: `A1:D10` や `B2`)。シート全体を読み取る場合は **Range** を空のままにします。
* **Value input option** は、書き込んだ内容を Google がどのように保存するかを決定します。**Formula / number (interpret as typed)** では、セルに直接入力した場合と同様に、`=SUM(A1:B1)` は数式として、`42` は数値として扱われます。**Plain text (no parsing)** では、テキストとして保存されます。
***
## トラブルシューティング
* 最初に **Google Account** を選択してください。選択するまでドロップダウンは無効のままです。
* ドロップダウンに **No files granted yet** と表示される場合、Profound はまだこのアカウントのどのファイルにもアクセスできません。**Add files from Google Drive** を選択し、Google のピッカーでファイルを選択してください。
* アカウントごとにアクセスできるファイルが異なるため、**Google Account** を変更すると、選択したファイルはクリアされます。
Profound が開けるのは、ピッカーで追加したファイルと Profound が作成したファイルのみです。そのファイルがこれらのいずれかであり、Drive にまだ存在していることを確認してください。URL または ID を貼り付けた場合は、選択した Google アカウントと同じアカウントのものであることを確認してください。
入力した値が ID でも URL でもないため、Profound は名前で検索しました。ドロップダウンからファイルを選択するか、URL または ID を貼り付けてください。
**Sheet name** は、スプレッドシートのタブ名と完全に一致している必要があります。スプレッドシートからコピーするか、フィールドを空のままにして最初のタブを使用してください。
エラーには、シートの行数と列数が示されます。その範囲内に収まる範囲を使用するか、先にシートに行や列を追加してください。
**Records** と **Columns** の出力形式では 1 行目がキーとして使用されるため、すべてのヘッダーが一意である必要があります。スプレッドシートで重複している列の名前を変更するか、**Output format** を **Rows**、**CSV**、またはその他の形式に切り替えてください。
**Input format** は、**Rows** のデータと一致している必要があります。たとえば、**Input format** が **CSV** に設定されている状態で JSON データを指定すると拒否されます。**Input format** をデータの形式に変更してください。
**Content format** が **HTML** に設定されている場合、**Initial Content** には `...
` などの HTML タグが含まれている必要があります。テキストをタグで囲むか、**Content format** を **Plain Text** または **Markdown** に切り替えてください。
* Profound がフォルダを見つけられない場合は、**Add a folder from Google Drive** からもう一度フォルダを選択してください。
* Profound がフォルダにアクセスできない場合は、接続した Google アカウントがファイルを追加できるフォルダを選択してください。
* 共有ドライブ内のフォルダの場合、接続したアカウントがその共有ドライブのメンバーであり、Google Workspace のルールでそこへのファイルの追加が許可されている必要があります。
* ドライブまたはフォルダの容量がいっぱいの場合は、空き容量を確保するか、別のドライブのフォルダを選択してください。
Profound がエクスポートできるのは、ドキュメントまたはプレゼンテーション 1 件あたり最大 5 MB です。ファイルを分割するか、より小さなドキュメントを読み取ってください。
接続した Google アカウントには、そのファイルの閲覧権限しかありません。ファイルのオーナーに編集者のアクセス権を依頼してから、ノードを再度実行してください。
Google は、一定期間に受け付けるリクエストの数を制限しています。しばらく待ってから、Agent を再度実行してください。この問題が繰り返し発生する場合は、Google Workspace の管理者に API の割り当ての見直しを依頼してください。
Google がそのアカウントに対する Profound のトークンを受け付けなくなっています。**Settings** > **Integrations** > **Google Drive** で接続を取り消し、[アカウントを再接続](/ja-jp/integrations/google-drive/connect-google-drive-to-profound#step-2)してください。