# Configurar tareas de reseñas de apps Google

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/app_data/google/app_reviews/task_post`

**Tags:** DataForSEO

Encola las reseñas de una app de Google Play por `app_id` y devuelve un `id` de tarea. `depth` define cuántas recopilar. Asíncrono: el envío devuelve un `id` de tarea en `tasks[0].id` y la herramienta de consulta devuelve el resultado cuando esté listo. Recupéralas con `get_dataforseo_app_google_app_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.

## Related links

- [Pricing](<https://dataforseo.com/pricing/api/google-play>)
- [Pricing](<https://dataforseo.com/pricing/app-data/google-play>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "app_id": {
            "type": "string",
            "description": "<em>id de la app</em><br><strong>campo obligatorio</strong><br>ID de la aplicación móvil en Google Play;<br>puedes encontrar el ID en la URL de cada app listada en Google Play;<br>ejemplo:<br><code>https://play.google.com/store/apps/details?id=<strong>org.telegram.messenger</strong></code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>nombre completo de la ubicación del motor de búsqueda</em><br><strong>campo obligatorio si no especificas <code>location_code</code></strong><br><strong>si usas este campo, no necesitas especificar <code>location_code</code></strong><br>puedes obtener la lista de ubicaciones disponibles del motor de búsqueda con su <code>location_name</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/app_data/google/locations</code><br>ejemplo:<br><code class=\"long-string\">West Los Angeles,California,United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>código de ubicación del motor de búsqueda</em><br><strong>campo obligatorio si no especificas <code>location_name</code></strong><br><strong>si usas este campo, no necesitas especificar <code>location_name</code></strong><br>puedes obtener la lista de ubicaciones disponibles del motor de búsqueda con su <code>location_code</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/app_data/google/locations</code><br>ejemplo:<br><code class=\"long-string\">9061121</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>nombre completo del idioma del motor de búsqueda</em><br><strong>campo obligatorio si no especificas <code>language_code</code></strong><br>si usas este campo, no necesitas especificar <code>language_code</code><br>puedes obtener la lista de idiomas disponibles con <code>language_name</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/app_data/google/languages</code><br>ejemplo:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>código de idioma del motor de búsqueda</em><br><strong>campo obligatorio si no especificas <code>language_name</code></strong><br>si usas este campo, no necesitas especificar <code>language_name</code><br>puedes obtener la lista de idiomas disponibles con su <code>language_code</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/app_data/google/languages</code><em><br></em>ejemplo:<em><br></em><code class=\"long-string\">en</code>"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>prioridad de la tarea</em><br>campo opcional<br>puede tomar los siguientes valores:<br>1 – prioridad de ejecución normal (definida de forma predeterminada)<br>2 – prioridad de ejecución alta Se te cobrará un cargo adicional por las tareas con prioridad de ejecución alta.<br>El costo puede calcularse en la página Pricing."
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>profundidad de análisis</em><br>campo opcional<br>número de reseñas que se devolverán en la respuesta de la API;<br>recomendamos encarecidamente definir la profundidad de análisis en múltiplos de 150, porque nuestro sistema procesa 150 reseñas seguidas;<br>valor predeterminado: <code>150</code>;<br>valor máximo: <code>100000</code>;<br><strong>Tu cuenta se factura por cada SERP que contenga hasta 150 resultados;</strong> <br>Definir una profundidad superior a 150 puede generar cargos adicionales si el motor de búsqueda devuelve más de 150 resultados</a>;<br>El costo puede calcularse en la página Pricing."
          },
          "rating": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>filtrar reseñas por valoración</em><br>campo opcional<br>puedes usar este campo para filtrar los resultados;<br>tipos de filtrado posibles:<br><code>5</code> — devuelve solo reseñas con cinco estrellas;<br><code>4</code> — devuelve solo reseñas con cuatro estrellas;<br><code>3</code> — devuelve solo reseñas con tres estrellas;<br><code>2</code> — devuelve solo reseñas con dos estrellas;<br><code>1</code> — devuelve solo reseñas con una estrella;<br>de forma predeterminada, la API devuelve todas las reseñas independientemente del número de estrellas"
          },
          "sort_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>parámetros de ordenación de los resultados</em><br>campo opcional<br>puedes usar este campo para ordenar los resultados;<br>tipos de ordenación posibles:<br><code>newest</code> — ordenar por las reseñas más recientes;<br><code>most_relevant</code> — ordenar por las reseñas más relevantes;<br>regla predeterminada: <code>most_relevant</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identificador de tarea definido por el usuario</em><br>campo opcional<br><em>el límite de caracteres es 255</em><br>puedes usar este parámetro para identificar la tarea y relacionarla con el resultado<br>encontrarás el valor de <code>tag</code> especificado en el objeto <code>data</code> de la respuesta"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL para enviar los resultados de la tarea</em><br>campo opcional<br>cuando se complete la tarea, enviaremos una solicitud POST con sus resultados comprimidos en formato <code>gzip</code> a la <code>postback_url</code> que hayas especificado<br>puedes usar la cadena ‘$id’ como variable <code>$id</code> y ‘$tag’ como variable <code>$tag</code> codificada en URL. Estableceremos los valores necesarios antes de enviar la solicitud.<br>ejemplo:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>Nota:</strong> los caracteres especiales de <code>postback_url</code> se codificarán en URL; <br>es decir, el carácter <code>#</code> se codificará como <code>%23</code>"
          },
          "postback_data": {
            "type": "string",
            "description": "<em>tipo de datos de postback_url</em><br><strong>campo obligatorio si especificas <code>postback_url</code></strong><br>corresponde al tipo de datos que se enviará a tu servidor<br>valores posibles:<br><code>advanced</code>, <code>html</code>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL de notificación de una tarea completada</em><br>campo opcional<br>cuando se complete una tarea, te avisaremos mediante una solicitud GET enviada a la URL que hayas especificado<br>puedes usar la cadena ‘$id’ como variable <code>$id</code> y ‘$tag’ como variable <code>$tag</code> codificada en URL. Estableceremos los valores necesarios antes de enviar la solicitud.<br>ejemplo:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>Nota:</strong> los caracteres especiales de <code>pingback_url</code> se codificarán en URL; <br>es decir, el carácter <code>#</code> se codificará como <code>%23</code>"
          }
        },
        "example": [
          {
            "app_id": "org.telegram.messenger",
            "location_code": 2840,
            "language_code": "en",
            "depth": 150
          }
        ]
      }
    ]
  },
  "example": [
    {
      "app_id": "org.telegram.messenger",
      "location_code": 2840,
      "language_code": "en",
      "depth": 150
    }
  ]
}
```

## Responses

### 200 — Operación correcta

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostResponseInfo"
    }
  ]
}
```

### 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**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>array de tareas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppReviewsTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>array de resultados</em><br>en este caso, el valor será <code>null</code>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "la versión actual de la API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado general\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo general\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo total de ejecución, en segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas devueltas con un error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identificador de la tarea\nidentificador único de la tarea en nuestro sistema en formato UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado de la tarea\ngenerado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo de la tarea\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo de ejecución, segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de elementos en el array de resultados",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "ruta de la URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contiene los mismos parámetros que especificaste en la solicitud POST"
    }
  }
}
```
