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

Question

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

От: 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 = blank

6/6/16 Обновление: изменение требования к плану пользовательских переменных

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

Затрагиваемые конечные точки: / опросы, / опросы /{id}, / опросы /{id}/ ответы / массовые, / сборщики /{id}/ ответы / массовые, / опросы /{id}/response /{id}, / сборщики /{идентификатор} / ответы /{идентификатор}, / опросы /{идентификатор} / ответы /{идентификатор} / подробности, / сборщики /{идентификатор} / ответы /{идентификатор} / подробности

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

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

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

Answer 1

Так что это два разных вида "пользовательских значений".

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

GET /v3/surveys/<survey_id>

Вы получите ответ как

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

  },
  ...
}

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

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"
                }
            },
            ...
          },
          ...
        }
        ...
    },
    ...
  }
}

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

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

Answer 2

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

https://api.surveymonkey.net/v3/surveys/{SURVEY_ID} / ответы / основная масса,

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

{
  "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.