Jinba FlowでGoogle Formsの作成と管理

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

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

Google OAuthで接続する

すべてのGoogle Formsツールは、GOOGLE_FORMS_OAUTH シークレットを参照する token 設定フィールドを取ります。JinbaシークレットダッシュボードでGoogle Forms用にGoogleアカウントを接続し、生成されたトークンを以下の例のようにツール設定で参照してください。注意：APIキーは機密情報として扱い、公開リポジトリにコミットしないでください。

ツール

GOOGLE_FORMS_CREATE_FORM

新しいGoogle Formを作成します。入力:

パラメータ	型	必須	説明
`title`	string	はい	フォームのタイトル
`description`	string	いいえ	フォームの説明（デフォルト: 空）
`publish`	boolean	いいえ	フォームを公開して回答を受け付ける（デフォルト: `true`）。2026-06-30 以降に API で作成したフォームは未公開状態で作られるため、下書きのままにする場合のみ `false` を指定。公開は作成時点で行われるため、`GOOGLE_FORMS_ADD_QUESTIONS` で質問を追加する前からフォームは公開状態になる

出力:

フィールド	型	説明
`formId`	string	作成されたフォームの一意識別子
`title`	string	作成されたフォームのタイトル
`responderUri`	string	回答者がフォームに回答するためのURL
`editUri`	string	フォームを編集するためのURL
`isPublished`	boolean	フォームが公開されているか（`publish` が `false` の場合は `false`）
`isAcceptingResponses`	boolean	フォームが回答を受け付けているか（`publish` が `false` の場合は `false`）

公開に失敗した場合: publish が true でフォームを公開できなかった場合、または Google が「回答を受け付けていない」と報告した場合、ステップは GoogleFormsPublishError で失敗します。フォームは既に作成されているため（再実行すると別のフォームが作られる）このエラーはリトライされません。作成済みフォームの formId と実際の公開状態は result に含まれるので、Google Forms の編集画面から手動で公開できます。

GOOGLE_FORMS_ADD_QUESTIONS

既存のGoogle Formに質問を追加します。入力:

パラメータ	型	必須	説明
`formId`	string	はい	変更するフォームのID
`questions`	array	はい	質問オブジェクトの配列（下記参照）。YAMLのリストまたはJSON配列文字列
`insertAtIndex`	integer	いいえ	質問を挿入する位置のインデックス（デフォルト: `0`）

questions 内の各オブジェクトには以下が含まれます:

フィールド	型	必須	説明
`title`	string	はい	質問タイトル
`type`	string	はい	質問タイプ: `SHORT_ANSWER`, `PARAGRAPH`, `MULTIPLE_CHOICE`, `CHECKBOXES`, `DROPDOWN`, `LINEAR_SCALE`, `DATE`, `TIME`, `MULTIPLE_CHOICE_GRID`, `CHECKBOX_GRID`
`description`	string	いいえ	質問の説明
`required`	boolean	いいえ	質問が必須かどうか（デフォルト: `false`）
`options`	array	いいえ	選択式質問（`MULTIPLE_CHOICE`、`CHECKBOXES`、`DROPDOWN`）の選択肢
`scaleSettings`	object	いいえ	`LINEAR_SCALE` 用: `low`（デフォルト `1`）、`high`（デフォルト `5`、最大 `10`）、`lowLabel`、`highLabel`
`gridSettings`	object	いいえ	グリッド質問用: `rows` と `columns`（ラベルの配列）、`type`（`RADIO`（デフォルト）または `CHECKBOX`）

出力:

フィールド	型	説明
`form`	object	Google Forms APIが返す更新後のフォーム
`questionsAdded`	number	追加された質問の数

GOOGLE_FORMS_BATCH_UPDATE

Google Forms APIの batchUpdate リクエストをフォームに適用します。入力:

パラメータ	型	必須	説明
`formId`	string	はい	更新するフォームのID
`requests`	array	はい	リクエストオブジェクトの配列（下記参照）。YAMLのリストまたはJSON配列文字列

requests 内の各オブジェクトには、Google Forms APIのリクエストと同じ構造で、以下のキーのうち1つだけを含めます:

キー	フィールド	説明
`createItem`	`item`, `location.index`	新しい項目を挿入
`updateItem`	`item`, `location.index`, `updateMask`	既存の項目を更新
`deleteItem`	`location.index`	項目を削除
`moveItem`	`originalLocation.index`, `newLocation.index`	項目を移動
`updateFormInfo`	`info`, `updateMask`	フォームのタイトルや説明を更新
`updateSettings`	`settings`, `updateMask`	フォーム設定を更新

出力:

フィールド	型	説明
`form`	object	Google Forms APIが返す更新後のフォーム
`replies`	array	Google Forms APIが返す、リクエストごとの応答

GOOGLE_FORMS_GET_FORM

Google Formの情報を取得します。入力:

form_id (文字列, 必須): 取得するフォームのID

出力:

フィールド	型	説明
`formId`	string	フォーム識別子
`title`	string	フォームタイトル
`description`	string	フォームの説明（設定されている場合）
`documentTitle`	string	Google Drive上のフォームドキュメントのタイトル
`responderUri`	string	回答者がフォームに回答するためのURL
`editUri`	string	フォームを編集するためのURL
`items`	array	フォームの項目。各項目は `title`、`description`、`questionItem`（存在する場合）を持つ

フォームを作成する

- id: create_feedback_form
  tool: GOOGLE_FORMS_CREATE_FORM
  config:
    - name: token
      value: "{{secrets.GOOGLE_FORMS_OAUTH}}"
  input:
    - name: title
      value: "お客様満足度調査"
    - name: description
      value: "サービスのご感想をお聞かせください。"

質問を追加する

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

フォームデータを取得する

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

フォームを一括更新する

- id: batch_update_form
  tool: GOOGLE_FORMS_BATCH_UPDATE
  needs: [add_questions]
  config:
    - name: token
      value: "{{secrets.GOOGLE_FORMS_OAUTH}}"
  input:
    - name: formId
      value: "{{steps.create_feedback_form.result.formId}}"
    - name: requests
      value:
        - updateFormInfo:
            info:
              title: "更新されたお客様満足度調査"
              description: "満足度調査の説明を更新しました"
            updateMask: "title,description"
        - updateItem:
            item:
              title: "更新された質問タイトル"
            location:
              index: 0
            updateMask: "title"

質問タイプ

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

MULTIPLE_CHOICE: 選択肢からの単一選択
CHECKBOXES: 選択肢からの複数選択
DROPDOWN: ドロップダウンメニュー選択
SHORT_ANSWER: 短いテキスト入力
PARAGRAPH: 長いテキスト入力
LINEAR_SCALE: 評価スケール（範囲は scaleSettings で設定）
MULTIPLE_CHOICE_GRID: 多項選択のグリッド質問（行と列は gridSettings で設定）
CHECKBOX_GRID: チェックボックスのグリッド質問（行と列は gridSettings で設定）
DATE: 日付選択
TIME: 時間選択

用途

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

​Google OAuthで接続する

​ツール

​GOOGLE_FORMS_CREATE_FORM

​GOOGLE_FORMS_ADD_QUESTIONS

​GOOGLE_FORMS_BATCH_UPDATE

​GOOGLE_FORMS_GET_FORM

​フォームを作成する

​質問を追加する

​フォームデータを取得する

​フォームを一括更新する

​質問タイプ

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

​用途