Form API を利用して、アンケートを管理することができます。
Form API は、User Account 認証で発行された Access Token でのみ呼び出すことができます。Service Account 認証 (JWT) で発行された Access Token では呼び出すことができません。
Scopes: form, form.read
アンケートの回答を取得することができます。
| HTTP Request | Description |
|---|---|
| GET /forms/{formId}/responses | アンケート回答結果の取得。回答結果の値については 補足 を参照ください。 |
| GET /forms/{formId}/responses/{responseId}/attachments/{attachmentId} | アンケート回答の添付ファイルダウンロード |
添付ファイルの取得方法の詳細は ファイルアップロード / ダウンロード を参照します。
アンケート回答結果の取得 で得られる回答データは全て文字列 (string) ですが、その質問の種類によって形式が異なります。
| questionType | answer |
|---|---|
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" |
ATTACHMENT | attachmentId が入ります。ファイルの取得方法は アンケート回答の添付ファイルダウンロード を参照ください。 |
Form API ではアンケートを指定するために formId を用います。例えば、アンケート回答結果の取得では、この formId で指定されたアンケートの回答結果を取得します。
formId はブラウザ版 LINE WORKS のアンケート画面の URL から取得できます。
https://form.worksmobile.com/forms/{formId}/summary のように URL 内に formId が存在します。繰り返しアンケートの場合
- 繰り返されるアンケートそれぞれで formId が異なります。
- 繰り返しアンケート内容の「繰り返しアンケートリスト」より該当のアンケートを表示し、その URL から formId を取得します。
- 参考: LINE WORKS ヘルプセンター > 繰り返しアンケート内容