生成AI活用研究
Excel×スプレッドシート連携：HTTP GETで学ぶGAS API設計入門

## Google Apps Script API作成依頼プロンプト (GETリクエストによる取得・設定)

**目的:**
ExcelからGoogleスプレッドシートのセルデータを取得および**設定**するためのGoogle Apps Script (GAS) を用いたWeb APIを作成します。このスクリプトは、HTTP GETリクエストのみでこれらの操作を実現し、ウェブアプリとしてデプロイされることを前提とします。

**APIの仕様概要:**

1.  **GASスクリプトの形態:**
    * このGAS APIは、後述する専用の「API管理スプレッドシート」に**紐付けられた（バインドされた）スクリプト**として作成してください。

2.  **API管理スプレッドシート:**
    * 「API管理スプレッドシート」内には、`ConfigSheet` という名前のシートが存在します。
    * `ConfigSheet` の1行目はヘッダー行とし、A列に `スプシ名` (操作対象を識別するための任意の名前)、B列に `スプレッドシートID` (操作対象スプレッドシートの実際のID) を記述して管理します。

    **`ConfigSheet` の例:**
    | スプシ名     | スプレッドシートID                     |
    | :----------- | :------------------------------------- |
    | 売上データ   | (ここに売上データスプレッドシートのID)   |
    | 在庫リスト   | (ここに在庫リストスプレッドシートのID)   |

3.  **APIエンドポイントと機能 (`doGet(e)` 関数のみ):**

    * HTTP GETリクエストを処理します。
    * **必須URLパラメータ:**
        * `spreadsheetName`: `ConfigSheet` の「スプシ名」に対応する文字列。
        * `sheetName`: 操作対象シートの実際のシート名。
        * `rangeA1`: 操作対象のセル範囲をA1形式で指定。
        * `action`: 操作の種類を指定します。"get" (取得) または "set" (設定)。
        * `value`: `action` が "set" の場合に必須。セルに設定する新しい値 (単一の文字列)。
    * **処理フロー:**
        1.  受け取った `spreadsheetName` を基に `ConfigSheet` を検索し、対応する「スプレッドシートID」を取得します。見つからない場合はエラーメッセージ（テキスト形式推奨、例: "エラー: 指定されたスプシ名が見つかりません。"）を返します。
        2.  取得した「スプレッドシートID」、およびパラメータの `sheetName` を使用して対象スプレッドシートおよびシートを開きます。シートが見つからない場合はエラーメッセージを返します。
        3.  `action` パラメータの値に応じて処理を分岐します。
            * **`action` が "get" の場合 (データ取得):**
                1.  指定された `rangeA1` のセル範囲の値を取得します。
                2.  取得した値 (二次元配列) をXML形式で返します。XMLの構造は以下を参考にしてください。
                    ```xml
                    <data>
                      <row>
                        <cell>値1A</cell>
                        <cell>値1B</cell>
                      </row>
                      <row>
                        <cell>値2A</cell>
                        <cell>値2B</cell>
                      </row>
                    </data>
                    ```
                    ※単一セルの場合は `<data><row><cell>値</cell></row></data>` のようになります。
                3.  XMLに含める文字列データは、必要に応じて適切にエスケープ処理してください。
                4.  範囲指定が不正などの場合は適切なエラーメッセージをXML形式で返します。
            * **`action` が "set" の場合 (データ設定):**
                1.  `value` パラメータが提供されているか確認します。不足している場合はエラーメッセージ（テキスト形式推奨、例: "エラー: valueパラメータが不足しています。"）を返します。
                2.  指定された `rangeA1` のセル範囲に、提供された単一の `value` を設定します (範囲内の全セルに同じ値を設定、または範囲が単一セルの場合はそのセルに設定)。
                3.  設定が成功した場合、成功を示すメッセージ（テキスト形式推奨、例: "設定成功: セル範囲に値を設定しました。"）を返します。
                4.  範囲指定が不正などの場合は適切なエラーメッセージ（テキスト形式推奨）を返します。
        4.  その他のエラー（パラメータ不足など）が発生した場合も、適切なエラーメッセージ（テキスト形式推奨）を返します。

4.  **ExcelからのAPI利用方法の説明作成依頼:**
    * 上記で作成されるGAS APIについて、Excelから利用する方法を説明するドキュメントまたはセクションを作成してください。説明には以下を含めてください。
        * **データ取得 (`action=get`):**
            * Excelの `WEBSERVICE` 関数を使用した具体的な呼び出し例（`spreadsheetName`, `sheetName`, `rangeA1`, `action=get` パラメータを含む）。
            * `ENCODEURL` 関数の使用推奨箇所。
            * 返却されるXMLデータをExcelシート上で扱うための簡単な方法 (例: `FILTERXML` 関数の利用例)。
        * **データ設定 (`action=set`):**
            * Excelの `WEBSERVICE` 関数を使用した具体的な呼び出し例（`spreadsheetName`, `sheetName`, `rangeA1`, `action=set`, `value` パラメータを含む）。
            * `ENCODEURL` 関数の使用推奨箇所。
            * GETリクエストによるデータ設定は一般的に推奨されない旨、およびその主なリスク（サーバーログへの記録、ブラウザ履歴、キャッシュ問題、べき等性の欠如など）について**簡潔に**注意喚起してください。
            * 返却されるテキストメッセージの確認方法。

5.  **GAS APIのデプロイ（公開）手順の説明作成依頼:**
    * 作成したGASスクリプトをウェブアプリとしてデプロイし、外部（Excelなど）からアクセス可能なURLを取得するまでの基本的な手順の概要を説明してください。
    * **説明に含めるべきポイント (簡潔に):**
        * スクリプトエディタの「デプロイ」メニューから「新しいデプロイ」を選択する流れ。
        * デプロイの種類として「ウェブアプリ」を選択すること。
        * 主な設定項目：「説明」(任意)、「次のユーザーとして実行」(通常は自分)、「アクセスできるユーザー」(この設定の重要性と、例えば「全員」を選択する場合のセキュリティ上の注意点)。
        * デプロイ後に発行される「ウェブアプリURL」の確認方法。

**補足:**
* このAPIは、GETリクエストによるデータ設定のリスクを理解した上で利用されることを前提としています。
* GASのウェブアプリとしてデプロイする際の設定（アクセス権限など）についても考慮が必要ですが、今回はスクリプト自体の作成と、その利用・デプロイに関する説明の作成に焦点を当てています。