Configurar tareas de Google Shopping Reviews
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurar tareas de Google Shopping Reviews
Encola las reseñas de un producto de Google Shopping y devuelve un id de tarea. Identifica el producto con product_id más gid o data_docid de un resultado de productos. Esta familia es asíncrona de principio a fin: el envío devuelve un id de tarea en tasks[0].id y la herramienta de consulta devuelve el resultado cuando esté listo. Recupera con get_dataforseo_merchant_google_reviews_fetch.
Referencia de precios
- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.012.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: array object[]
- Tipo: object
- gidTipo: stringobligatorio
identificador global del producto en Google Shopping campo obligatorio recomendamos especificar gid junto con data_docid y product_id para obtener resultados óptimos; puedes obtener este valor para un producto determinado haciendo una solicitud independiente al endpoint Google Shopping Products ejemplo: 4702526954592161872 más información sobre el parámetro en esta guía del Centro de ayuda
- dataTipo: string
_docid identificador único del elemento de datos de SERP campo opcional recomendamos especificar data_docid junto con product_id y gid para obtener resultados óptimos; puedes obtener este valor para un elemento determinado haciendo una solicitud independiente al endpoint Google Shopping Products ejemplo: 13071766526042404278
- depthTipo: integer
profundidad de análisis campo opcional número de reseñas en la SERP; recomendamos encarecidamente definir la profundidad de análisis en múltiplos de diez, porque nuestro sistema procesa diez reseñas seguidas; valor máximo: 8000 valor predeterminado: 10 Tu cuenta se facturará por cada SERP que contenga hasta 10 resultados; Definir una profundidad superior a 10 puede generar cargos adicionales si el motor de búsqueda devuelve más de 10 resultados; El costo puede calcularse en la página de precios.
- languageTipo: string
_code código de idioma del motor de búsqueda campo obligatorio si no especificas language_name si usas este campo, no necesitas especificar language_name puedes obtener la lista de idiomas disponibles con sus parámetros language_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/merchant/google/languages ejemplo: en_GB
- languageTipo: string
_name nombre completo del idioma del motor de búsqueda campo obligatorio si no especificas language_code si usas este campo, no necesitas especificar language_code puedes obtener la lista de idiomas disponibles con sus parámetros language_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/merchant/google/languages ejemplo: English (United Kingdom)
- locationTipo: integer
_code código de ubicación del motor de búsqueda campo obligatorio si no especificas location_name ni location_coordinate si usas este campo, no necesitas especificar location_name ni location_coordinate puedes obtener la lista de ubicaciones disponibles con sus parámetros location_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/merchant/google/locations ejemplo: 9045969
- locationTipo: string
_coordinate coordenadas GPS de una ubicación campo obligatorio si no especificas location_name ni location_code si usas este campo, no necesitas especificar location_name ni location_code el parámetro location_coordinate debe especificarse en el formato “latitude,longitude,radius” el número máximo de dígitos decimales para “latitude” y “longitude”: 7 el valor mínimo para “radius”: 199.9 ejemplo: 53.476225,-2.243572,200
- locationTipo: string
_name nombre completo de la ubicación del motor de búsqueda campo obligatorio si no especificas location_code ni location_coordinate si usas este campo, no necesitas especificar location_code ni location_coordinate puedes obtener la lista de ubicaciones disponibles con sus parámetros location_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/merchant/google/locations ejemplo: HA1,England,United Kingdom
- pingbackTipo: string
_url URL de notificación de una tarea completada campo opcional cuando se completa una tarea, te notificaremos mediante una solicitud GET enviada a la URL que hayas especificado puedes usar la cadena ‘$id’ como variable $id y ‘$tag’ como variable $tag codificada para URL. Estableceremos los valores necesarios antes de enviar la solicitud. ejemplo: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Nota: los caracteres especiales de pingback_url se codificarán para URL; por ejemplo, el carácter # se codificará como %23 obtén más información en nuestro Centro de ayuda
- postbackTipo: string
_data tipo de datos de postback_url campo opcional corresponde al tipo de datos que se enviará a tu servidor valores posibles: advanced
- postbackTipo: string
_url URL para enviar los resultados de la tarea campo opcional una vez completada la tarea, enviaremos una solicitud POST con sus resultados comprimidos en formato gzip al postback_url que especificaste puedes usar la cadena ‘$id’ como variable $id y ‘$tag’ como variable $tag codificada para URL. Estableceremos los valores necesarios antes de enviar la solicitud. ejemplo: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Nota: los caracteres especiales de postback_url se codificarán para URL; por ejemplo, el carácter # se codificará como %23 obtén más información en nuestro Centro de ayuda
- priorityTipo: integer
prioridad de la tarea campo opcional puede tomar los siguientes valores: 1 – prioridad de ejecución normal (establecida de forma predeterminada) 2 – prioridad de ejecución alta Se te cobrará un cargo adicional por las tareas con prioridad de ejecución alta. el costo puede calcularse en la página Pricing.
- productTipo: string
_id identificador único de producto en Google Shopping campo opcional recomendamos especificar product_id junto con data_docid y gid para obtener resultados óptimos; puedes obtener este valor para un producto concreto haciendo una solicitud independiente al endpoint Google Shopping Products ejemplo: 4485466949985702538 obtén más información sobre el parámetro en esta guía del centro de ayuda
- seTipo: string
_domain dominio del motor de búsqueda campo opcional elegimos el dominio del motor de búsqueda relevante automáticamente según la ubicación y el idioma que especifiques no obstante, puedes definir un dominio de motor de búsqueda personalizado en este campo ejemplo: google.co.uk, google.com.au, google.de, etc.
- tagTipo: string
identificador de tarea definido por el usuario campo opcional el límite de caracteres es 255 puedes usar este parámetro para identificar la tarea y relacionarla con el resultado encontrarás el valor tag especificado en el objeto data de la respuesta
Objeto vacíoObjeto vacío
- Tipo: object200
Respuesta correcta
- Tipo: numbercost
costo total de las tareas, USD
- Tipo: integerstatus
_code código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí Nota: recomendamos encarecidamente diseñar un sistema para gestionar las condiciones excepcionales o de error relacionadas
- Tipo: stringstatus
_message mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí
- Tipo: array string[]tasks
array de tareas
- Tipo: integertasks
_count el número de tareas en el array tasks
- Tipo: integertasks
_error el número de tareas en el array de tareas devueltas con un error
- Tipo: numbertasks
.cost costo de la tarea, USD
- Tipo: objecttasks
.data contiene los mismos parámetros que especificaste en la solicitud POST
- Tipo: stringtasks
.id identificador único de la tarea en nuestro sistema en el formato de identificador único universal (UUID)
- Tipo: array string[]tasks
.path ruta de la URL
- Tipo: array string[]tasks
.result array de resultados en este caso, el valor será null
- Tipo: integertasks
.result _count número de elementos en el array de resultados
- Tipo: integertasks
.status _code código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000
- Tipo: stringtasks
.status _message mensaje informativo de la tarea
- Tipo: stringtasks
.time tiempo de ejecución, segundos
- Tipo: stringtime
tiempo de ejecución, segundos
- Tipo: stringversion
la versión actual de la API
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
application/json
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"
]
}