v0.2.0-beta

OpenAPI 3.1.0

Створення завдань Google Shopping Reviews

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/reviews/task_post

Створення завдань Google Shopping Reviews

Ставить у чергу відгуки про один товар Google Shopping і повертає id завдання. Визначте товар за product_id і gid або data_docid з результату products. Усе це сімейство асинхронне: submit повертає id завдання в tasks[0].id, а інструмент fetch повертає результат, коли він готовий. Отримуйте результат через get_dataforseo_merchant_google_reviews_fetch.

Довідкові ціни

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

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло

обов'язкове

application/json

Тип: array object[]
- Тип: object
  gid
  Тип: string
  обов'язкове
  
  глобальний ідентифікатор продукту в Google Shopping, обов'язкове поле. Для оптимальних результатів рекомендуємо вказувати gid разом із data_docid і product_id. Це значення для певного продукту можна отримати, надіславши окремий запит до ендпоінта Google Shopping Products. приклад: 4702526954592161872. Докладніше про параметр — у цьому посібнику довідкового центру
  
  data_docid
  Тип: string
  
  унікальний ідентифікатор елемента даних SERP, необов'язкове поле. Для оптимальних результатів рекомендуємо вказувати data_docid разом із product_id і gid. Це значення для певного елемента можна отримати, надіславши окремий запит до ендпоінта Google Shopping Products. приклад: 13071766526042404278
  
  depth
  Тип: integer
  
  глибина парсингу, необов'язкове поле. Кількість відгуків у SERP. Ми наполегливо рекомендуємо задавати глибину парсингу кратну десяти, оскільки наша система обробляє по десять відгуків підряд. Максимальне значення: 8000. Значення за замовчуванням: 10. З кожного SERP, що містить до 10 результатів, з вашого облікового запису стягується плата. Установлення глибини понад 10 може призвести до додаткових витрат, якщо пошукова система поверне більше 10 результатів. Вартість можна розрахувати на сторінці тарифів.
  
  language_code
  Тип: string
  
  код мови пошукової системи, обов'язкове поле, якщо не вказано language_name. Якщо використовуєте це поле, language_name вказувати не потрібно. Список доступних мов і відповідних параметрів language_code можна отримати окремим запитом до https://api.dataforseo.com/v3/merchant/google/languages. приклад: en_GB
  
  language_name
  Тип: string
  
  повна назва мови пошукової системи, обов'язкове поле, якщо не вказано language_code. Якщо використовуєте це поле, language_code вказувати не потрібно. Список доступних мов і відповідних параметрів language_name можна отримати окремим запитом до https://api.dataforseo.com/v3/merchant/google/languages. приклад: English (United Kingdom)
  
  location_code
  Тип: integer
  
  код місцеположення пошукової системи, обов'язкове поле, якщо не вказано location_name або location_coordinate. Якщо використовуєте це поле, location_name або location_coordinate вказувати не потрібно. Список доступних місцеположень і відповідних параметрів location_code можна отримати окремим запитом до https://api.dataforseo.com/v3/merchant/google/locations. приклад: 9045969
  
  location_coordinate
  Тип: string
  
  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_name
  Тип: string
  
  повна назва місцеположення пошукової системи, обов'язкове поле, якщо не вказано location_code або location_coordinate. Якщо використовуєте це поле, location_code або location_coordinate вказувати не потрібно. Список доступних місцеположень і відповідних параметрів location_name можна отримати окремим запитом до https://api.dataforseo.com/v3/merchant/google/locations. приклад: HA1,England,United Kingdom
  
  pingback_url
  Тип: string
  
  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
  
  тип даних postback_url необов'язкове поле відповідає типу даних, який буде надіслано на ваш сервер можливі значення: advanced
  
  postback_url
  Тип: string
  
  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
  
  пріоритет завдання необов'язкове поле може набувати таких значень: 1 – звичайний пріоритет виконання (встановлюється за замовчуванням) 2 – високий пріоритет виконання За завдання з високим пріоритетом виконання стягується додаткова плата. вартість можна розрахувати на сторінці Pricing.
  
  product_id
  Тип: string
  
  унікальний ідентифікатор продукту в Google Shopping необов'язкове поле для оптимальних результатів радимо вказувати product_id разом із data_docid і gid; значення для конкретного продукту можна отримати, надіславши окремий запит до ендпоінта Google Shopping Products приклад: 4485466949985702538 докладніше про параметр — у цьому посібнику Help Center
  
  se_domain
  Тип: string
  
  домен пошукової системи необов'язкове поле відповідний домен пошукової системи вибирається автоматично з урахуванням указаних вами місцезнаходження й мови однак у цьому полі можна задати власний домен пошукової системи приклад: google.co.uk, google.com.au, google.de тощо
  
  tag
  Тип: string
  
  визначений користувачем ідентифікатор завдання. Необов'язкове поле. Обмеження — 255 символів. Цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом. Вказане значення tag ви знайдете в об'єкті data відповіді.
  
  Порожній об'єкт
  Порожній об'єкт

Відповіді

200
Тип: object

Успішна відповідь
cost
Тип: number

загальна вартість завдань, USD

status_code
Тип: integer

загальний код стану. Повний список кодів відповіді можна знайти тут. Примітка: ми наполегливо рекомендуємо передбачити систему обробки пов'язаних виняткових ситуацій і помилок.

status_message
Тип: string

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

tasks
Тип: array string[]

масив завдань

tasks_count
Тип: integer

кількість завдань у масиві tasks

tasks_error
Тип: integer

кількість завдань у масиві tasks, повернутих з помилкою

tasks.cost
Тип: number

вартість завдання, USD

tasks.data
Тип: object

містить ті самі параметри, які ви вказали в POST-запиті

tasks.id
Тип: string

унікальний ідентифікатор завдання в нашій системі у форматі універсального унікального ідентифікатора (UUID)

tasks.path
Тип: array string[]

шлях URL

tasks.result
Тип: array string[]

масив результатів. У цьому випадку значення буде null

tasks.result_count
Тип: integer

кількість елементів у масиві result

tasks.status_code
Тип: integer

код стану завдання, згенерований DataForSEO; може бути в такому діапазоні: 10000-60000

tasks.status_message
Тип: string

інформаційне повідомлення завдання

tasks.time
Тип: string

час виконання, секунди

time
Тип: string

час виконання, секунди

version
Тип: string

поточна версія API
application/json
400

Не вдалося обробити запит. Перевірте параметри запиту.
401

Потрібен дійсний API-ключ Felo.
402

Запит неможливо виконати: умови білінгу не виконано.
403

Обліковий запис не має дозволу на цю операцію.
429

Досягнуто ліміту запитів або витрат.
502

Служба не змогла виконати запит.
503

API або служба білінгу тимчасово недоступні.
504

Час очікування обробки запиту вичерпано.
default

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

application/json

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

curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'

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

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

Успішна відповідь

Створення завдань Google Shopping Reviews

АвтентифікаціяRequired

DataForSEO

Створення завдань Google Shopping Reviews

Довідкові ціни