Form API

Form API を利用して、アンケートを管理することができます。
Form API は、User Account 認証で発行された Access Token でのみ呼び出すことができます。Service Account 認証 (JWT) で発行された Access Token では呼び出すことができません。

Scopes: form, form.read

アンケートの回答取得 {#get-form-response}

アンケートの回答を取得することができます。

HTTP RequestDescription
GET /forms/{formId}/responsesアンケート回答結果の取得。回答結果の値については 補足 を参照ください。
GET /forms/{formId}/responses/{responseId}/attachments/{attachmentId}アンケート回答の添付ファイルダウンロード

添付ファイルの取得方法の詳細は ファイルアップロード / ダウンロード を参照します。

補足: アンケート回答結果の値について {#form-answer-value}

アンケート回答結果の取得 で得られる回答データは全て文字列 (string) ですが、その質問の種類によって形式が異なります。

questionTypeanswer
SINGLE_CHOICE , MULTIPLE_CHOICE , TEXT , DROPDOWN形式なし。各項目の値が入ります。
RATING数値が入ります。

例. "1", "2.5"
SINGLE_DATE , MULTIPLE_DATE , DATE_INPUT , DATETIME_INPUT日付または日時が入ります。

例.
・2025.04.01 (火) → "2025-04-01"
(形式 YYYY-MM-DD)
・2025.04.01 (火) 09:30 → "2025-04-01T09:30:00+09:00"
(形式 YYYY-MM-DDThh:mm:ssTZD)
・2025.04.01 (火) 09:30~15:00 → "2025-04-01T09:30:00+09:00/2025-04-01T15:00:00+09:00"
(形式 YYYY-MM-DDThh:mm:ssTZD/YYYY-MM-DDThh:mm:ssTZD)
・2025.04.01 (火) 午前 → "2025-04-01T00:00:00+09:00/2025-04-01T11:59:59+09:00"
・ 2025.04.01 (火) 午後 → "2025-04-01T12:00:00+09:00/2025-04-01T23:59:59+09:00"
ATTACHMENTattachmentId が入ります。

ファイルの取得方法は アンケート回答の添付ファイルダウンロード を参照ください。

formId の取得方法 {#how-to-get-formid}

Form API ではアンケートを指定するために formId を用います。例えば、アンケート回答結果の取得では、この formId で指定されたアンケートの回答結果を取得します。

formId はブラウザ版 LINE WORKS のアンケート画面の URL から取得できます。

  1. アンケートの一覧画面より該当のアンケートを選択し、アンケートの内容を表示します。
    • 参考: LINE WORKS ヘルプセンター > アンケートの内容
  2. 表示されているアンケート内容画面の URL より formId を取得します。
    • https://form.worksmobile.com/forms/{formId}/summary のように URL 内に formId が存在します。

繰り返しアンケートの場合

  • 繰り返されるアンケートそれぞれで formId が異なります。
  • 繰り返しアンケート内容の「繰り返しアンケートリスト」より該当のアンケートを表示し、その URL から formId を取得します。
  • 参考: LINE WORKS ヘルプセンター > 繰り返しアンケート内容