> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Googleスプレッドシート（上級）

> 一括データ操作のための高度なGoogleスプレッドシート操作

## 概要

Googleスプレッドシート上級ツールは、Googleシートでの一括操作のための包括的な機能を提供します。これらのツールは、複数行、シート、複雑なデータ操作の管理のための高度な機能で基本的なGoogleシートツールを補完します。

## 主な機能

* `GOOGLE_SPREADSHEET_ADD_ROW`
  * Googleシートに単一行を追加
* `GOOGLE_SPREADSHEET_ADD_ROWS`
  * Googleシートに一度に複数行を追加
* `GOOGLE_SPREADSHEET_UPDATE_ROW`
  * Googleシートの特定の行を更新
* `GOOGLE_SPREADSHEET_UPDATE_ROWS`
  * Googleシートの複数行を更新
* `GOOGLE_SPREADSHEET_GET_ROWS`
  * Googleシートから複数行を取得
* `GOOGLE_SPREADSHEET_ADD_SHEET`
  * Googleスプレッドシート内に新しいシートを作成
* `GOOGLE_SPREADSHEET_REMOVE_SHEET`
  * Googleスプレッドシートからシートを削除

## 認証

詳細については[こちらをクリック](/ja/pages/credentials/google-oauth)してください。

GoogleシートAPI認証情報を設定する必要があります。以下の手順に従ってください：

1. [Google Cloud Console](https://console.cloud.google.com/)にアクセス
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択
3. Google Sheets APIを有効にする
4. サービスアカウント認証情報を作成し、JSONキーファイルをダウンロード
5. サービスアカウントのメールアドレスとGoogleスプレッドシートを共有

**注意**: API認証情報は機密情報として扱い、パブリックリポジトリにコミットしないでください。

### 例: 一括データ操作

```yaml theme={null}
- id: add_multiple_rows
  name: add_multiple_rows
  tool: GOOGLE_SPREADSHEET_ADD_ROWS
  config:
    - name: credentials
      value: "{{secrets.GOOGLE_SHEETS_CREDENTIALS}}"
  input:
    - name: spreadsheet_id
      value: "your_spreadsheet_id_here"
    - name: sheet_name
      value: "データ"
    - name: values
      value: [
        ["田中太郎", "tanaka@example.com", "マネージャー", "2024-01-15"],
        ["佐藤花子", "sato@example.com", "開発者", "2024-01-16"],
        ["鈴木一郎", "suzuki@example.com", "デザイナー", "2024-01-17"]
      ]

- id: update_multiple_rows
  name: update_multiple_rows
  tool: GOOGLE_SPREADSHEET_UPDATE_ROWS
  config:
    - name: credentials
      value: "{{secrets.GOOGLE_SHEETS_CREDENTIALS}}"
  input:
    - name: spreadsheet_id
      value: "your_spreadsheet_id_here"
    - name: sheet_name
      value: "データ"
    - name: start_row
      value: 2
    - name: values
      value: [
        ["田中太郎（更新）", "tanaka.taro@example.com", "シニアマネージャー", "2024-01-15"],
        ["佐藤花子（更新）", "sato.hanako@example.com", "シニア開発者", "2024-01-16"]
      ]
```

### 例: シート管理

```yaml theme={null}
- id: create_new_sheet
  name: create_new_sheet
  tool: GOOGLE_SPREADSHEET_ADD_SHEET
  config:
    - name: credentials
      value: "{{secrets.GOOGLE_SHEETS_CREDENTIALS}}"
  input:
    - name: spreadsheet_id
      value: "your_spreadsheet_id_here"
    - name: sheet_name
      value: "月次レポート_{{current_date}}"

- id: setup_headers
  name: setup_headers
  tool: GOOGLE_SPREADSHEET_ADD_ROW
  config:
    - name: credentials
      value: "{{secrets.GOOGLE_SHEETS_CREDENTIALS}}"
  input:
    - name: spreadsheet_id
      value: "your_spreadsheet_id_here"
    - name: sheet_name
      value: "月次レポート_{{current_date}}"
    - name: values
      value: ["名前", "メール", "部署", "開始日", "ステータス"]
```

## ヒントとベストプラクティス

* 大きな更新操作の前にバックアップを作成することを検討する
* 新しいシートを作成する際は意味のあるシート名を使用する
* 大きなデータセットにエラーハンドリングを実装する
* 大量操作のAPIクォータ使用量を監視する
* より良いパフォーマンスのためにバッチ操作を使用する