転送元 - SurveyMonkey

本ページでは、SurveyMonkeyからデータを取得するための設定（転送設定）について説明します。
接続に関する設定については、接続情報 - SurveyMonkeyを参照ください。

利用上の注意・制約

API Rate Limit

SurveyMonkey APIには、一定期間内のリクエスト回数に制限があります。
TROCCOのSurveyMonkeyコネクタのクライアント認証の形式はPublic Appsでの提供となり、上限はクライアント認証アプリごとに設定されます。
クライアント認証アプリで500,000リクエスト/日の制限を超えると、HTTP 429エラーが返され、一時的にAPIが使用できなくなります。詳細はSurveyMonkey公式ドキュメント − Public AppsおよびSurveyMonkey公式ドキュメント − Request and Response Limitsを参照ください。

取得対象

アンケート一覧

認証されたユーザーが所有または共有しているアンケートの一覧を取得します。
詳しくは、SurveyMonkey公式ドキュメント − GET /surveysを参照ください。

設定項目

項目名	必須	デフォルト値	説明
更新日時（開始）	-	-	指定した日時以降に更新されたアンケートのみを取得します。形式：`YYYY-MM-DDTHH:MM:SSZ`（例：`2023-01-01T00:00:00Z`）
更新日時（終了）	-	-	指定した日時以前に更新されたアンケートのみを取得します。形式：`YYYY-MM-DDTHH:MM:SSZ`（例：`2023-12-31T23:59:59Z`）

取得データ

カラム名	デフォルトのデータ型	補足事項
`id`	`string`	アンケートID
`title`	`string`	アンケートのタイトル
`nickname`	`string`	アンケートのニックネーム
`href`	`string`	アンケートのURL

アンケート詳細情報

指定したアンケートの詳細情報を取得します。
詳しくは、SurveyMonkey公式ドキュメント − GET /surveys/{id}/detailsを参照ください。

設定項目

項目名	必須	デフォルト値	説明
アンケートID	✓	-	詳細情報を取得したいアンケートのIDを入力します。アンケートIDは「アンケート一覧」の取得対象から確認できます。

取得データ

カラム名	デフォルトのデータ型	補足事項
`title`	`string`	アンケートのタイトル
`nickname`	`string`	アンケートのニックネーム
`language`	`string`	アンケートの言語
`folder_id`	`string`	アンケートが格納されているフォルダーID
`category`	`string`	アンケートのカテゴリー
`question_count`	`long`	アンケート内の質問数
`page_count`	`long`	アンケートのページ数
`response_count`	`long`	回答数
`date_created`	`string`	アンケート作成日時
`date_modified`	`string`	アンケート最終更新日時
`id`	`string`	アンケートID
`buttons_text`	`json`	ボタンテキスト情報
`is_owner`	`boolean`	オーナーかどうか
`footer`	`boolean`	フッター表示フラグ
`theme_id`	`string`	テーマID
`template_id`	`string`	テンプレートID
`custom_variables`	`json`	カスタム変数情報
`href`	`string`	アンケートのURL
`analyze_url`	`string`	分析用URL
`edit_url`	`string`	編集用URL
`collect_url`	`string`	収集用URL
`summary_url`	`string`	サマリー用URL
`preview`	`string`	プレビューURL
`pages`	`json`	ページ情報

連絡先一覧

SurveyMonkeyアカウント内の連絡先一覧を取得します。
連絡先一覧を取得するには View Contacts scope が必要です。
詳しくは、SurveyMonkey公式ドキュメント − Get contactsを参照ください。

設定項目

設定項目はありません。

取得データ

カラム名	デフォルトのデータ型	補足事項
`id`	`string`	連絡先ID
`first_name`	`string`	名前（名）
`last_name`	`string`	名前（姓）
`email`	`string`	メールアドレス
`phone_number`	`string`	電話番号
`href`	`string`	連絡先のURL
`custom_fields`	`json`	カスタムフィールド情報
`status`	`string`	連絡先のステータス

アンケートコレクター一覧

指定したアンケートのコレクター一覧を取得します。
詳しくは、SurveyMonkey公式ドキュメント − Get collectors for a surveyを参照ください。

設定項目

項目名	必須	デフォルト値	説明
アンケートID	✓	-	コレクター一覧を取得したいアンケートのIDを入力します。アンケートIDは「アンケート一覧」の取得対象から確認できます。

取得データ

カラム名	デフォルトのデータ型	補足事項
`name`	`string`	コレクターの名前
`id`	`string`	コレクターID
`href`	`string`	コレクターのURL
`type`	`string`	コレクターのタイプ

アンケート回答一覧

指定したアンケートの回答一覧を取得します。
詳しくは、SurveyMonkey公式ドキュメント − Get responses for a survey (bulk)を参照ください。

設定項目

項目名	必須	デフォルト値	説明
アンケートID	✓	-	回答一覧を取得したいアンケートのIDを入力します。アンケートIDは「アンケート一覧」の取得対象から確認できます。

取得データ

カラム名	デフォルトのデータ型	補足事項
`id`	`string`	回答ID
`recipient_id`	`string`	回答者ID
`collection_mode`	`string`	回答収集モード
`response_status`	`string`	回答ステータス
`custom_value`	`string`	カスタム値
`first_name`	`string`	回答者の名前（名）
`last_name`	`string`	回答者の名前（姓）
`email_address`	`string`	回答者のメールアドレス
`ip_address`	`string`	回答者のIPアドレス
`logic_path`	`json`	ロジックパス情報
`metadata`	`json`	メタデータ情報
`page_path`	`json`	ページパス情報
`collector_id`	`string`	コレクターID
`survey_id`	`string`	アンケートID
`language`	`string`	回答時の言語
`custom_variables`	`json`	カスタム変数情報
`edit_url`	`string`	回答編集用URL
`analyze_url`	`string`	回答分析用URL
`total_time`	`long`	回答にかかった合計時間（秒）
`date_modified`	`timestamp`	回答の最終更新日時
`date_created`	`timestamp`	回答の作成日時
`href`	`string`	回答のURL
`pages`	`json`	ページ情報

アンケートロールアップ情報

指定したアンケートのロールアップ情報（集計データ）を取得します。
詳しくは、SurveyMonkey公式ドキュメント − Get survey rollupsを参照ください。

設定項目

項目名	必須	デフォルト値	説明
アンケートID	✓	-	ロールアップ情報を取得したいアンケートのIDを入力します。アンケートIDは「アンケート一覧」の取得対象から確認できます。

取得データ

カラム名	デフォルトのデータ型	補足事項
`id`	`string`	質問ID
`family`	`string`	質問のファミリータイプ
`subtype`	`string`	質問のサブタイプ
`href`	`string`	質問のURL
`summary`	`json`	質問の集計情報