# Configurer les tâches Google App List

**API:** Data API

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

**Tags:** DataForSEO

Met en file d'attente l'une des collections sélectionnées de Google Play — gratuites, plus grosses recettes, tendances —, choisie avec `app_collection`, et renvoie un `id` de tâche. `depth` limite la profondeur de lecture du classement. Asynchrone : la soumission renvoie un `id` de tâche dans `tasks[0].id` et l'outil de récupération renvoie le résultat une fois prêt. Récupérez avec `get_dataforseo_app_google_app_list_fetch`. C'est la vue classement ; pour une recherche par mot-clé, utilisez `post_dataforseo_app_google_app_searches_submit`.

### Référence tarifaire

- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.012.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation 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_collection": {
            "type": "string",
            "description": "<em>collection d'applications</em><br><strong>champ obligatoire</strong><br>collection d'applications sur Google Play à partir de laquelle les applications seront collectées ;<br>vous pouvez spécifier les valeurs suivantes :<br><code>featured</code>, <code>topselling_paid</code>, <code>topselling_free</code>, <code>topselling_new_free</code>, <code>topselling_new_paid</code>, <code>topgrossing</code>, <code>movers_shakers</code><br><strong>Remarque :</strong> si <code>featured</code> est sélectionné, le paramètre <code>app_category</code> ne peut pas être utilisé"
          },
          "location_name": {
            "type": "string",
            "description": "<em>nom complet de la localisation du moteur de recherche</em><br><strong>champ obligatoire si vous ne spécifiez pas <code>location_code</code></strong><br><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>location_code</code></strong><br>vous pouvez obtenir la liste des localisations disponibles du moteur de recherche avec leur <code>location_name</code> en effectuant une requête distincte vers <code>https://api.dataforseo.com/v3/app_data/google/locations</code><br>exemple :<br><code class=\"long-string\">West Los Angeles,California,United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>code de localisation du moteur de recherche</em><br><strong>champ obligatoire si vous ne spécifiez pas <code>location_name</code></strong><br><strong>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>location_name</code></strong><br>vous pouvez obtenir la liste des localisations disponibles du moteur de recherche avec leur <code>location_code</code> en effectuant une requête distincte vers <code>https://api.dataforseo.com/v3/app_data/google/locations</code><br>exemple :<br><code class=\"long-string\">9061121</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>nom complet de la langue du moteur de recherche</em><br><strong>champ obligatoire si <code>language_code</code> n'est pas spécifié</strong><br>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>language_code</code><br>vous pouvez obtenir la liste des langues disponibles avec <code>language_name</code> en effectuant une requête distincte vers <code>https://api.dataforseo.com/v3/app_data/google/languages</code><br>exemple :<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>code de langue du moteur de recherche</em><br><strong>champ obligatoire si <code>language_name</code> n'est pas spécifié</strong><br>si vous utilisez ce champ, vous n'avez pas besoin de spécifier <code>language_name</code><br>vous pouvez obtenir la liste des langues disponibles avec leur <code>language_code</code> en effectuant une requête distincte vers <code>https://api.dataforseo.com/v3/app_data/google/languages</code><em><br></em>exemple :<em><br></em><code class=\"long-string\">en</code>"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>priorité de la tâche</em><br>champ facultatif<br>peut prendre les valeurs suivantes :<br>1 – priorité d'exécution normale (définie par défaut)<br>2 – priorité d'exécution élevée Vous serez facturé un supplément pour les tâches à priorité d'exécution élevée.<br>Le coût peut être calculé sur la page Pricing."
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>profondeur d'analyse</em><br>champ facultatif<br>nombre d'applications à renvoyer dans la réponse de l'API ;<br>nous recommandons vivement de définir la profondeur d'analyse par multiples de 100, car notre système traite 100 résultats d'affilée ;<br>valeur par défaut : <code>100</code> ;<br>valeur maximale : <code>200</code> ;<br><strong>Votre compte sera facturé pour chaque SERP contenant jusqu'à 100 résultats ;</strong> <br>Définir une profondeur supérieure à 100 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 100 résultats</a> ;<br>Le coût peut être calculé sur la page Pricing."
          },
          "app_category": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>catégorie d'application sur Google Play</em><br>champ facultatif<br>vous pouvez filtrer les résultats par catégorie d'application ;<br>exemple :<br><code>family</code> ;<br>vous pouvez obtenir la liste complète des catégories disponibles en effectuant une requête distincte vers <code>https://api.dataforseo.com/v3/app_data/google/categories</code><br><strong>Remarque :</strong> <code>app_category</code> ne peut pas être utilisé si le paramètre <code>app_collection</code> est défini sur <code>featured</code>"
          },
          "age_rating": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>filtrer les résultats par classification par âge</em><br>champ facultatif<br>vous pouvez utiliser ce champ pour filtrer les résultats par classification par âge ;<br>types de filtrage possibles :<br><code>ages_up_to_5</code> — renvoie les applications approuvées pour les enfants jusqu'à 5 ans ;<br><code>ages_6_8</code> — renvoie les applications approuvées pour les enfants de 6 à 8 ans ;<br><code>ages_9_12</code> — renvoie les applications approuvées pour les enfants de 9 à 12 ans ;<br>par défaut, l'API renvoie les applications pour tous les âges ;<br><strong>Remarque :</strong> ce filtre ne fonctionne qu'avec le paramètre <code>\"category\": \"family\"</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identifiant de tâche défini par l'utilisateur</em><br>champ facultatif<br><em>la limite est de 255 caractères</em><br>vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat<br>vous trouverez la valeur <code>tag</code> spécifiée dans l'objet <code>data</code> de la réponse"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL d'envoi des résultats de la tâche</em><br>champ facultatif<br>une fois la tâche terminée, nous envoyons une requête POST avec ses résultats compressés au format <code>gzip</code> vers le <code>postback_url</code> que vous avez spécifié<br>vous pouvez utiliser la chaîne ‘$id’ comme variable <code>$id</code> et ‘$tag’ comme variable <code>$tag</code> encodée dans l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.<br>exemple :<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>Remarque :</strong> les caractères spéciaux dans <code>postback_url</code> seront encodés dans l'URL ; <br>notamment, le caractère <code>#</code> sera encodé en <code>%23</code>"
          },
          "postback_data": {
            "type": "string",
            "description": "<em>type de données de postback_url</em><br><strong>champ obligatoire si vous spécifiez <code>postback_url</code></strong><br>correspond au type de données qui sera envoyé à votre serveur<br>valeurs possibles :<br><code>advanced</code>, <code>html</code>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL de notification d'une tâche terminée</em><br>champ facultatif<br>lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée<br>vous pouvez utiliser la chaîne ‘$id’ comme variable <code>$id</code> et ‘$tag’ comme variable <code>$tag</code> encodée dans l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.<br>exemple :<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>Remarque :</strong> les caractères spéciaux dans <code>pingback_url</code> seront encodés dans l'URL ; <br>notamment, le caractère <code>#</code> sera encodé en <code>%23</code>"
          }
        },
        "example": [
          {
            "app_collection": "topselling_free",
            "location_code": 2840,
            "language_code": "en",
            "depth": 100
          }
        ]
      }
    ]
  },
  "example": [
    {
      "app_collection": "topselling_free",
      "location_code": 2840,
      "language_code": "en",
      "depth": 100
    }
  ]
}
```

## Responses

### 200 — Opération réussie

Headers:
- `X-Request-Id` (string) — Identifiant de requête à inclure lorsque vous contactez le support Felo.

**application/json**

Schema: object | null

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

### 400 — La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

### 401 — Une clé API Felo valide est requise.

### 402 — La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

### 403 — Le compte n'est pas autorisé à effectuer cette opération.

### 429 — Une limite de requêtes ou de dépenses a été atteinte.

### 502 — Le service n'a pas pu terminer la requête.

### 503 — L'API ou le service de facturation est temporairement indisponible.

### 504 — Le service a expiré lors du traitement de la requête.

### default — Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AppDataGoogleAppListTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppListTaskPostResponseInfo`

```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_AppDataGoogleAppListTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>tableau de tâches</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AppDataGoogleAppListTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_AppDataGoogleAppListTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>tableau de résultats</em><br>dans ce cas, la valeur sera <code>null</code>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "la version actuelle de l'API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "code d'état général\nvous pouvez trouver la liste complète des codes de réponse ici"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "message d'information général\nvous pouvez trouver la liste complète des messages d'information généraux ici"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "temps d'exécution total, en secondes"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "coût total des tâches, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "le nombre de tâches dans le tableau de tâches",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "le nombre de tâches dans le tableau de tâches renvoyées avec une erreur",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identifiant de la tâche\nidentifiant unique de la tâche dans notre système au format UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "code d'état de la tâche\ngénéré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000\nvous pouvez trouver la liste complète des codes de réponse ici"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "message d'information de la tâche\nvous pouvez trouver la liste complète des messages d'information généraux ici"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "temps d'exécution, en secondes"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "coût total des tâches, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "nombre d'éléments dans le tableau de résultats",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "chemin de l'URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contient les mêmes paramètres que ceux spécifiés dans la requête POST"
    }
  }
}
```
