Настройка задач Google Shopping Reviews

глобальный идентификатор продукта в Google Shopping, обязательное поле. Для оптимальных результатов рекомендуем указывать gid вместе с data_docid и product_id. Это значение для определённого продукта можно получить, отправив отдельный запрос к эндпоинту Google Shopping Products. пример: 4702526954592161872. Подробнее о параметре — в этом руководстве справочного центра

уникальный идентификатор элемента данных SERP, необязательное поле. Для оптимальных результатов рекомендуем указывать data_docid вместе с product_id и gid. Это значение для определённого элемента можно получить, отправив отдельный запрос к эндпоинту Google Shopping Products. пример: 13071766526042404278

глубина парсинга, необязательное поле. Количество отзывов в SERP. Мы настоятельно рекомендуем задавать глубину парсинга кратную десяти, так как наша система обрабатывает по десять отзывов подряд. Максимальное значение: 8000. Значение по умолчанию: 10. С каждого SERP, содержащего до 10 результатов, с вашего аккаунта взимается плата. Установка глубины выше 10 может привести к дополнительным расходам, если поисковая система вернёт больше 10 результатов. Стоимость можно рассчитать на странице тарифов.

код языка поисковой системы, обязательное поле, если не указан language_name. Если используете это поле, language_name указывать не нужно. Список доступных языков и соответствующих параметров language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/merchant/google/languages. пример: en_GB

полное название языка поисковой системы, обязательное поле, если не указан language_code. Если используете это поле, language_code указывать не нужно. Список доступных языков и соответствующих параметров language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/merchant/google/languages. пример: English (United Kingdom)

код местоположения поисковой системы, обязательное поле, если не указан location_name или location_coordinate. Если используете это поле, location_name или location_coordinate указывать не нужно. Список доступных местоположений и соответствующих параметров location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/merchant/google/locations. пример: 9045969

GPS-координаты местоположения, обязательное поле, если не указан location_name или location_code. Если используете это поле, location_name или location_code указывать не нужно. Параметр location_coordinate указывается в формате «latitude,longitude,radius». Максимальное число десятичных знаков для «latitude» и «longitude»: 7. Минимальное значение для «radius»: 199.9. пример: 53.476225,-2.243572,200

полное название местоположения поисковой системы, обязательное поле, если не указан location_code или location_coordinate. Если используете это поле, location_code или location_coordinate указывать не нужно. Список доступных местоположений и соответствующих параметров location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/merchant/google/locations. пример: HA1,England,United Kingdom

URL уведомления о завершённой задаче необязательное поле по завершении задачи мы отправим GET-запрос на указанный вами URL строку ‘$id’ можно использовать как переменную $id, а ‘$tag’ — как urlencoded-переменную $tag. Перед отправкой запроса мы подставим нужные значения. пример: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Примечание: специальные символы в pingback_url будут urlencoded; в частности, символ # будет закодирован как %23 подробнее в нашем Help Center

тип данных postback_url необязательное поле соответствует типу данных, который будет отправлен на ваш сервер возможные значения: advanced

URL для отправки результатов задачи необязательное поле по завершении задачи мы отправим POST-запрос с результатами, сжатыми в формате gzip, на указанный вами postback_url строку ‘$id’ можно использовать как переменную $id, а ‘$tag’ — как urlencoded-переменную $tag. Перед отправкой запроса мы подставим нужные значения. пример: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Примечание: специальные символы в postback_url будут urlencoded; в частности, символ # будет закодирован как %23 подробнее в нашем Help Center

приоритет задачи необязательное поле может принимать следующие значения: 1 – обычный приоритет выполнения (устанавливается по умолчанию) 2 – высокий приоритет выполнения За задачи с высоким приоритетом выполнения взимается дополнительная плата. стоимость можно рассчитать на странице Pricing.

уникальный идентификатор продукта в Google Shopping необязательное поле для оптимальных результатов рекомендуем указывать product_id вместе с data_docid и gid; значение для конкретного продукта можно получить, отправив отдельный запрос к эндпоинту Google Shopping Products пример: 4485466949985702538 подробнее о параметре — в этом руководстве Help Center

домен поисковой системы необязательное поле подходящий домен поисковой системы выбирается автоматически с учётом указанных вами местоположения и языка однако в этом поле можно задать собственный домен поисковой системы пример: google.co.uk, google.com.au, google.de и т. д.

пользовательский идентификатор задачи. Необязательное поле. Ограничение — 255 символов. Этот параметр позволяет идентифицировать задачу и сопоставить её с результатом. Указанное значение tag вы найдёте в объекте data ответа.