メインコンテンツへスキップ

​
概要

Google Formsツールを使用すると、プログラムでGoogle Formsの作成と管理、質問の追加、一括更新の実行、フォーム情報の取得ができます。これらのツールは、調査、フィードバック収集、データ収集のための包括的なフォーム管理機能を提供します。

​
主な機能

  • GOOGLE_FORMS_CREATE_FORM: 新しいGoogle Formsを作成
  • GOOGLE_FORMS_ADD_QUESTIONS: 既存のフォームに質問を追加
  • GOOGLE_FORMS_BATCH_UPDATE: フォームの一括更新を実行
  • GOOGLE_FORMS_GET_FORM: フォーム情報と構造を取得

​
認証

これらのツールには、Google Forms APIにアクセスできるGoogle OAuth認証情報が必要です。Google Cloud Consoleを通じてOAuth認証情報をセットアップし、Google Forms APIを有効にする必要があります。 注意：APIキーは機密情報として扱い、公開リポジトリにコミットしないでください。

​
ツール

​
GOOGLE_FORMS_CREATE_FORM

新しいGoogle Formを作成します。 入力:
  • title (文字列, 必須): フォームのタイトル
  • description (文字列, オプション): フォームの説明
  • document_title (文字列, オプション): ドキュメントタイトル（デフォルトはフォームタイトル）
出力:
  • form_id: 作成されたフォームの一意識別子
  • form_url: フォームへの直接URL
  • edit_url: フォームを編集するためのURL
  • response_url: 回答を表示するためのURL

​
GOOGLE_FORMS_ADD_QUESTIONS

既存のGoogle Formに質問を追加します。 入力:
  • form_id (文字列, 必須): 変更するフォームのID
  • questions (配列, 必須): 次の内容を含む質問オブジェクトの配列:
    • title (文字列, 必須): 質問タイトル
    • type (文字列, 必須): 質問タイプ（“multiple_choice”, “text”, “paragraph_text”, “checkboxes”, “dropdown”, “linear_scale”, “multiple_choice_grid”, “checkbox_grid”, “date”, “time”, “file_upload”）
    • required (boolean, オプション): 質問が必須かどうか
    • options (配列, オプション): 選択式質問のオプション
    • description (文字列, オプション): 質問の説明
出力:
  • updated_form_id: フォームID
  • question_ids: 追加された質問のIDの配列
  • form_url: 更新されたフォームのURL

​
GOOGLE_FORMS_BATCH_UPDATE

Google Formの一括更新を実行します。 入力:
  • form_id (文字列, 必須): 更新するフォームのID
  • updates (配列, 必須): 次の内容を含む更新リクエストの配列:
    • update_type (文字列): 更新タイプ（“update_form_info”, “update_item”, “move_item”, “delete_item”）
    • update_data (オブジェクト): 更新固有のデータ
出力:
  • form_id: 更新されたフォームID
  • update_results: 各更新操作の結果
  • form_url: 更新されたフォームのURL

​
GOOGLE_FORMS_GET_FORM

Google Formの情報を取得します。 入力:
  • form_id (文字列, 必須): 取得するフォームのID
出力:
  • form_info: 次の内容を含む完全なフォーム情報:
    • form_id: フォーム識別子
    • title: フォームタイトル
    • description: フォーム説明
    • questions: 設定を含む全質問の配列
    • settings: フォーム設定（メール収集、回答制限など）
    • response_count: 受信した回答数

​
使用例

​
例：新しいフォームを作成する

- id: create_feedback_form
  tool: GOOGLE_FORMS_CREATE_FORM
  config:
    - name: oauth_credentials
      value: "{{secrets.GOOGLE_OAUTH_CREDENTIALS}}"
  input:
    - name: title
      value: "お客様満足度調査"
    - name: description
      value: "フィードバックを共有してサービス向上にご協力ください"
    - name: document_title
      value: "お客様満足度調査 2024"

​
例：フォームに質問を追加する

- id: add_questions
  tool: GOOGLE_FORMS_ADD_QUESTIONS
  config:
    - name: oauth_credentials
      value: "{{secrets.GOOGLE_OAUTH_CREDENTIALS}}"
  input:
    - name: form_id
      value: "{{steps.create_feedback_form.result.form_id}}"
    - name: questions
      value:
        - title: "弊社のサービスをどのように評価しますか？"
          type: "linear_scale"
          required: true
          description: "1（悪い）から5（優秀）で評価してください"
        - title: "改善すべき点はありますか？"
          type: "paragraph_text"
          required: false
          description: "詳細なフィードバックをお聞かせください"
        - title: "他の方に弊社をおすすめしますか？"
          type: "multiple_choice"
          required: true
          options:
            - "絶対におすすめする"
            - "おすすめする"
            - "わからない"
            - "おすすめしない"
            - "絶対におすすめしない"

​
例：フォーム情報を取得する

- id: get_form_details
  tool: GOOGLE_FORMS_GET_FORM
  config:
    - name: oauth_credentials
      value: "{{secrets.GOOGLE_OAUTH_CREDENTIALS}}"
  input:
    - name: form_id
      value: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"

​
例：フォームの一括更新

- id: batch_update_form
  tool: GOOGLE_FORMS_BATCH_UPDATE
  config:
    - name: oauth_credentials
      value: "{{secrets.GOOGLE_OAUTH_CREDENTIALS}}"
  input:
    - name: form_id
      value: "{{steps.create_feedback_form.result.form_id}}"
    - name: updates
      value:
        - update_type: "update_form_info"
          update_data:
            title: "更新されたお客様満足度調査"
            description: "満足度調査の説明を更新しました"
        - update_type: "update_item"
          update_data:
            item_id: "question_1"
            title: "更新された質問タイトル"

​
質問タイプ

​
サポートされている質問タイプ:

  • multiple_choice: オプションからの単一選択
  • checkboxes: オプションからの複数選択
  • dropdown: ドロップダウンメニュー選択
  • text: 短いテキスト入力
  • paragraph_text: 長いテキスト入力
  • linear_scale: 評価スケール（1-5、1-10など）
  • multiple_choice_grid: 多項選択のグリッド質問
  • checkbox_grid: チェックボックスのグリッド質問
  • date: 日付選択
  • time: 時間選択
  • file_upload: ファイルアップロードフィールド

​
用途

  • 顧客フィードバック収集
  • 調査・アンケート作成
  • イベント登録フォーム
  • 従業員フィードバックとHR調査
  • 教育評価とクイズ
  • 市場調査とデータ収集
  • 応募・お問い合わせフォーム
  • テンプレートからの自動フォーム生成