v0.2.0-beta

OpenAPI 3.1.0

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

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клиентские библиотеки

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операции

post/v1/beta/dataforseo/merchant/google/sellers/task_post

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

Ставит в очередь список продавцов, предлагающих один товар Google Shopping, и возвращает id задачи. Всё это семейство асинхронное: submit возвращает id задачи в tasks[0].id, а инструмент fetch возвращает результат, когда он готов. Получайте результат через get_dataforseo_merchant_google_sellers_fetch.

Справочная информация о ценах

Тарификация: заявленная стоимость ответа.
Справочная оценка запроса: USD 0.012.
Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Тело

application/json

Тип: array (object | null)[]
- additional_specifications
  Тип: object | null
  
  объект с дополнительными параметрами URL
  дополнительную информацию о продукте можно получить с помощью объекта "additional_specifications, который доступен при отдельном запросе к эндпоинту Google Shopping Products
  пример:
  "additional_specifications": { "eto": "16157121050167572763_0" }
  
  propertyName
  Тип: string | null
- data_docid
  Тип: string
  
  уникальный идентификатор элемента данных SERP
  обязательное поле, если не указан product_id или gid
  для оптимальных результатов рекомендуем указывать data_docid вместе с product_id и gid;
  это значение для определённого элемента можно получить, отправив отдельный запрос к эндпоинту Google Shopping Products
  пример:
  13071766526042404278
- depth
  Тип: integer | null
  
  глубина парсинга
  необязательное поле
  количество результатов, извлекаемых из SERP Google Shopping
  значение по умолчанию: 10
  максимальное значение: 200
  с вашего аккаунта взимается плата за каждый SERP, содержащий до 10 результатов;
  установка глубины больше 10 может привести к дополнительным расходам, если поисковая система возвращает более 10 результатов;
  стоимость можно рассчитать на странице Pricing
- get_shops_on_google
  Тип: boolean | null
  
  включить магазины "buy on Google"
  необязательное поле
  если задано true, ответ будет содержать список продавцов, которые позволяют приобрести товар напрямую в Google
  Примечание: если задано true, стоимость задачи удваивается
- gid
  Тип: string
  
  глобальный идентификатор продукта в Google Shopping
  обязательное поле, если не указан product_id или data_docid
  для оптимальных результатов рекомендуем указывать gid вместе с product_id и data_docid;
  это значение для определённого продукта можно получить, отправив отдельный запрос к эндпоинту Google Shopping Products
  пример:
  4702526954592161872
  подробнее о параметре — в этом руководстве справочного центра
- language_code
  Тип: string
  
  код языка
  обязательное поле, если не указан language_name
  если используете это поле, language_name указывать не нужно
  список доступных языков Google Shopping с их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/merchant/google/languages
  пример:
  en
- language_name
  Тип: string
  
  полное название языка
  обязательное поле, если не указан language_code
  если используете это поле, language_code указывать не нужно
  список доступных языков Google Shopping с их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/merchant/google/languages
  пример:
  English
- location_code
  Тип: integer
  
  код местоположения
  обязательное поле, если не указан location_name или location_coordinate
  если используете это поле, location_name или location_coordinate указывать не нужно
  список доступных местоположений Google Shopping с их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/merchant/google/locations
  пример:
  2840
- location_coordinate
  Тип: string
  
  GPS-координаты местоположения
  обязательное поле, если не указан location_name или location_code
  если используете это поле, location_name или location_code указывать не нужно
  параметр location_coordinate указывается в формате "широта,долгота,радиус"
  максимальное число десятичных знаков для "широты" и "долготы": 7
  минимальное значение для "радиуса": 199.9
  пример:
  53.476225,-2.243572,200
- location_name
  Тип: string
  
  полное название местоположения
  обязательное поле, если не указан location_code или location_coordinate
  если используете это поле, location_code или location_coordinate указывать не нужно
  список доступных местоположений Google Shopping с их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/merchant/google/locations
  пример:
  London,England,United Kingdom
- pingback_url
  Тип: string | null
  
  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_data
  Тип: string | null
- postback_url
  Тип: string | null
  
  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
- priority
  Тип: integer | null
  
  приоритет задачи
  необязательное поле
  может принимать следующие значения:
  1 — обычный приоритет выполнения (устанавливается по умолчанию)
  2 — высокий приоритет выполнения. За задачи с высоким приоритетом взимается дополнительная плата.
  Стоимость можно рассчитать на странице тарифов.
- product_id
  Тип: string
  
  уникальный идентификатор продукта в Google Shopping
  обязательное поле, если не указан data_docid или gid
  для оптимальных результатов рекомендуем указывать product_id вместе с data_docid и gid;
  это значение для определённого продукта можно получить, отправив отдельный запрос к эндпоинту Google Shopping Products
  пример:
  4485466949985702538
  подробнее о параметре — в этом руководстве справочного центра
- pvf
  Тип: string | null
  
  фильтр вариантов товара в Google Shopping
  необязательное поле
  параметр в URL Google Shopping, задающий необязательную фильтрацию вариантов товара;
  пример:
  Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpemUqAnhs
- se_domain
  Тип: string | null
  
  домен поисковой системы
  необязательное поле
  подходящий домен поисковой системы выбирается автоматически с учётом указанных вами местоположения и языка
  однако в этом поле можно задать собственный домен поисковой системы
  пример:
  google.co.uk, google.com.au, google.de и т. д.
- tag
  Тип: string | null
  
  пользовательский идентификатор задачи
  необязательное поле
  ограничение — 255 символов
  этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
  указанное значение tag вы найдёте в объекте data ответа

Ответы

200
Тип: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostResponseInfo
cost
Тип: number | null Формат: double

общая стоимость задач, USD

status_code
Тип: integer | null

общий код состояния. Полный список кодов ответа можно найти здесь.

status_message
Тип: string | null

общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.

tasks
Тип: array (object | null)[] | null

массив задач

Тип: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostTaskInfo
cost
Тип: number | null Формат: double

общая стоимость задач, USD

data
Тип: object | null

содержит те же параметры, что вы указали в POST-запросе

propertyName
Тип: object | null
id
Тип: string | null

идентификатор задачи уникальный идентификатор задачи в нашей системе в формате UUID

path
Тип: array (string | null)[] | null

путь URL

result
Тип: object | null

массив результатов
в этом случае значение будет null

result_count
Тип: integer | null Формат: int64

число элементов в массиве result

status_code
Тип: integer | null

код состояния задачи формируется DataForSEO, может находиться в диапазоне 10000-60000 Полный список кодов ответа можно найти здесь.

status_message
Тип: string | null

информационное сообщение задачи Полный список общих информационных сообщений можно найти здесь.

time
Тип: string | null

время выполнения, секунды

tasks_count
Тип: integer | null Формат: int64

число задач в массиве tasks

tasks_error
Тип: integer | null Формат: int64

число задач в массиве tasks, возвращённых с ошибкой

time
Тип: string | null

общее время выполнения, секунды

version
Тип: string | null

текущая версия API
application/json
400

Запрос не удалось обработать. Проверьте параметры запроса.
401

Требуется действительный API-ключ Felo.
402

Запрос не может быть выполнен: не выполнено требование биллинга.
403

Аккаунту не разрешено выполнять эту операцию.
429

Достигнут лимит запросов или расходов.
502

Сервис не смог выполнить запрос.
503

API или сервис биллинга временно недоступны.
504

Истекло время ожидания обработки запроса.
default

Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

application/json

post/v1/beta/dataforseo/merchant/google/sellers/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/sellers/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "product_id": "1113158713975221117"
  }
]'

Показать схему

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

Успешная операция

Нужна помощь?

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

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

АутентификацияRequired

DataForSEO

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

Справочная информация о ценах

Нужна помощь?