Survey Monkey — Пользовательские значения через API v3

В настоящее время я не могу понять, как получить несколько настраиваемых полей через API. Выдержки из Excel предоставляют нужные мне столбцы, но я не могу найти протокол v3 GET или POST для получения нужных полей.

Откуда: api.surveymonkey.net/v3/surveys/[survey_id]/details

Я вижу нужные поля:

  1. custom_variables.a = [Переменная имя столбца]
  2. custom_variables.b = [Имя столбца переменной b]

Со следующим: api.surveymonkey.net/v3/surveys/[survey_id]/responses/bulk?page=[#]&per_page=[#]

  1. data.0.custom_value = пусто
  2. data.0.recipient_id = пусто

Обновление 6 октября 2016 г.: изменение требований к плану пользовательских переменных

Описание изменений: сделать пользовательские переменные опроса доступными для плана Gold и выше.

Затронутые конечные точки: /surveys, /surveys/{id}, /surveys/{id}/responses/bulk, /collectors/{id}/responses/bulk, /surveys/{id}/responses /{id}, /collectors/{id}/responses/{id}, /surveys/{id}/responses/{id}/details, /collectors/{id}/responses/{id}/details

Я исчерпал свой лимит вызовов API и еще не смог запустить /collectors/{id}/responses. Я подумал, что лучше спросить сейчас и получить правильный ответ (чтобы я мог закончить этот проект и уложиться в срок, когда мой «счетчик» будет сброшен). В качестве информации я использую Alteryx для совершения звонков, и как только я закончу эту часть, я опубликую рабочий процесс на сайте Alteryx (чтобы немного отблагодарить сообщество).

Заранее спасибо за вашу помощь!

-Нарисовалась


api alteryx surveymonkey
person Drew Weaver    schedule 01.03.2017    source источник

Ответы (2)


arrow_upward
1
arrow_downward

Итак, это два разных типа «пользовательских значений».

Существуют Пользовательские переменные, которые в основном представляют собой параметры URL, которые будут приняты и сохранены вместе с ответом на опрос. Они работают только для сборщиков, не использующих электронную почту, особенно для сборщиков веб-ссылок. Пользовательские переменные также хранятся в опросе, поэтому, когда вы выбираете с помощью

GET /v3/surveys/<survey_id>

Вы получите ответ вроде

{
  "title": "My Survey",
  "custom_variables": {
    "name1": "label1",
    "name2": "label2"
    ...

  },
  ...
}

Затем, когда вы получаете ответы на опрос, предполагая, что они были заполнены in, вы получите такой ответ:

GET /v3/surveys/<survey_id>/responses/<response_id>
{
  "id": "<response_id>",
  "response_status": "completed",
  "custom_variables": {
    "name1": "value1",
    "name2": "value2"
    ...
  },
  ...
}

Что касается Пользовательских значений, это пользовательские данные, хранящиеся в Контакте. ресурс в вашей адресной книге, используемый для создания получателя в сборщике электронной почты (не в опросе).

Поэтому, когда вы создаете нового получателя на сборщик электронной почты, вы можете установить custom_fields, которые хранятся в контакте, а также в получателе. Когда вы получите этого получателя, он будет выглядеть примерно так:

GET /v3/collectors/<collector_id>/recipients/<recipient_id>
{
    "id": "<recipient_id>",
    "email": "<email>",
    "first_name": "<first_name>",
    "last_name": "<last_name>",
    "custom_fields": {
      "1": "field1",
      "2": "field2",
      "3": "field3",
      ...
    }
    ...
}

И затем, когда этот конкретный получатель ответит на опрос и вы получите ответ, вы получите контактную информацию в метаданных ответа, например:

GET /v3/surveys/<survey_id>/responses/<response_id>
{
  "id": "<response_id>",
  "response_status": "completed",
  "metadata": {
    "contact": {
        {
          "id": "<response_id>",
          "response_status": "completed",
          "metadata": {
            "contact": {
                "first_name": {
                  "type": "string",
                  "value": "<first_name>"
                },
                "last_name": {
                  "type": "string",
                  "value": "<last_name>"
                },
                "name1": {
                  "type": "string",
                  "value": "value1"
                },
                "name2": {
                  "type": "string",
                  "value": "value2"
                },
                "name3": {
                  "type": "string",
                  "value": "value3"
                }
            },
            ...
          },
          ...
        }
        ...
    },
    ...
  }
}

Обратите внимание, что метаданные будут содержать только имя, фамилию и адрес электронной почты в Конечная точка массовых ответов. Это текущее ограничение для массовых ответов.

Надеюсь, это поможет прояснить разницу.

person General Kandalaft    schedule 01.03.2017
comment
Спасибо за суперинформативный пост. Я знаю, что это было два года назад, но я очень признателен за то, что SurveyMonkey написал свою документацию так четко, как это :) - person Stan Lin; 30.08.2019

arrow_upward
0
arrow_downward

Когда вы используете указанный ниже URL

https://api.surveymonkey.net/v3/surveys/{SURVEY_ID}/responses /масса,

в ответ вы получаете пользовательские переменные,

{
  "per_page": 50,
  "total": 6,
  "data": [
    {
      "total_time": 108,
      "href":"https://api.surveymonkey.net/v3/surveys/119486428/responses/6287196301",
      "custom_variables": {
      "key1": "value1",
      "key2": "value2"
    },
}

Я использую веб-сборщик. и добавление пользовательских переменных в качестве параметра URL.

person Daidipya    schedule 21.07.2017