Felo API PlatformFelo API Platform
Todos los endpoints de DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Configurar tareas de Google Shopping Reviews

Servidor:https://openapi.felo.ai
Bibliotecas cliente

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.

Cuerpo
obligatorio
application/json
  • Tipo: array object[]
    • Tipo: object
      • gid
        Tipo: string
        obligatorio

        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

      • data_docid
        Tipo: string

        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

      • depth
        Tipo: 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.

      • language_code
        Tipo: string

        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

      • language_name
        Tipo: string

        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)

      • location_code
        Tipo: integer

        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

      • location_coordinate
        Tipo: string

        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

      • location_name
        Tipo: string

        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

      • pingback_url
        Tipo: string

        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

      • postback_data
        Tipo: string

        tipo de datos de postback_url campo opcional corresponde al tipo de datos que se enviará a tu servidor valores posibles: advanced

      • postback_url
        Tipo: string

        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

      • priority
        Tipo: 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.

      • product_id
        Tipo: string

        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

      • se_domain
        Tipo: string

        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.

      • tag
        Tipo: 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ío
      Objeto vacío
Respuestas
  • 200
    Tipo: object

    Respuesta correcta

    • cost
      Tipo: number

      costo total de las tareas, USD

    • status_code
      Tipo: integer

      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

    • status_message
      Tipo: string

      mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí

    • tasks
      Tipo: array string[]

      array de tareas

    • tasks_count
      Tipo: integer

      el número de tareas en el array tasks

    • tasks_error
      Tipo: integer

      el número de tareas en el array de tareas devueltas con un error

    • tasks.cost
      Tipo: number

      costo de la tarea, USD

    • tasks.data
      Tipo: object

      contiene los mismos parámetros que especificaste en la solicitud POST

    • tasks.id
      Tipo: string

      identificador único de la tarea en nuestro sistema en el formato de identificador único universal (UUID)

    • tasks.path
      Tipo: array string[]

      ruta de la URL

    • tasks.result
      Tipo: array string[]

      array de resultados en este caso, el valor será null

    • tasks.result_count
      Tipo: integer

      número de elementos en el array de resultados

    • tasks.status_code
      Tipo: integer

      código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000

    • tasks.status_message
      Tipo: string

      mensaje informativo de la tarea

    • tasks.time
      Tipo: string

      tiempo de ejecución, segundos

    • time
      Tipo: string

      tiempo de ejecución, segundos

    • version
      Tipo: string

      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
Request Example for 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"
  ]
}
Setting Google Shopping Reviews Tasks