Felo API PlatformFelo API Platform
Tous les endpoints DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Configurer les tâches Google Shopping Reviews

Serveur:https://openapi.felo.ai
Bibliothèques clientes

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Configurer les tâches Google Shopping Reviews

​

Met en file d'attente les avis d'un produit Google Shopping et renvoie un id de tâche. Identifiez le produit avec product_id plus gid ou data_docid d'un résultat de produits. Cette famille est entièrement asynchrone : la soumission renvoie un id de tâche dans tasks[0].id et l'outil de récupération renvoie le résultat dès qu'il est prêt. Récupérez avec get_dataforseo_merchant_google_reviews_fetch.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.012.
  • Multiplicateur de référence client : 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.

Corps
obligatoire
application/json
  • Type: array object[]
    • Type: object
      • gid
        Type: string
        obligatoire

        identifiant global du produit sur Google Shopping champ obligatoire nous recommandons d'indiquer gid avec data_docid et product_id pour des résultats optimaux ; vous pouvez obtenir cette valeur pour un produit donné en effectuant une requête distincte sur le point de terminaison Google Shopping Products exemple : 4702526954592161872 en savoir plus sur le paramètre dans ce guide du centre d'aide

      • data_docid
        Type: string

        identifiant unique de l'élément de données SERP champ facultatif nous recommandons d'indiquer data_docid avec product_id et gid pour des résultats optimaux ; vous pouvez obtenir cette valeur pour un élément donné en effectuant une requête distincte sur le point de terminaison Google Shopping Products exemple : 13071766526042404278

      • depth
        Type: integer

        profondeur d'analyse champ facultatif nombre d'avis dans la SERP ; nous recommandons vivement de définir la profondeur d'analyse par multiples de dix, car notre système traite dix avis d'affilée ; valeur maximale : 8000 valeur par défaut : 10 Votre compte sera facturé pour chaque SERP contenant jusqu'à 10 résultats ; Définir une profondeur supérieure à 10 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 10 résultats ; Le coût peut être calculé sur la page Tarifs.

      • language_code
        Type: string

        code de langue du moteur de recherche champ obligatoire si vous ne spécifiez pas language_name si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name vous pouvez obtenir la liste des langues disponibles avec leurs paramètres language_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/merchant/google/languages exemple : en_GB

      • language_name
        Type: string

        nom complet de la langue du moteur de recherche champ obligatoire si vous ne spécifiez pas language_code si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_code vous pouvez obtenir la liste des langues disponibles avec leurs paramètres language_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/merchant/google/languages exemple : English (United Kingdom)

      • location_code
        Type: integer

        code d'emplacement du moteur de recherche champ obligatoire si vous ne spécifiez pas location_name ni location_coordinate si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ni location_coordinate vous pouvez obtenir la liste des emplacements disponibles avec leurs paramètres location_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/merchant/google/locations exemple : 9045969

      • location_coordinate
        Type: string

        coordonnées GPS d'un emplacement champ obligatoire si vous ne spécifiez pas location_name ni location_code si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ni location_code le paramètre location_coordinate doit être indiqué au format « latitude,longitude,radius » le nombre maximal de décimales pour « latitude » et « longitude » : 7 la valeur minimale pour « radius » : 199.9 exemple : 53.476225,-2.243572,200

      • location_name
        Type: string

        nom complet de l'emplacement du moteur de recherche champ obligatoire si vous ne spécifiez pas location_code ni location_coordinate si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code ni location_coordinate vous pouvez obtenir la liste des emplacements disponibles avec leurs paramètres location_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/merchant/google/locations exemple : HA1,England,United Kingdom

      • pingback_url
        Type: string

        URL de notification d'une tâche terminée champ facultatif lorsqu'une tâche est terminée, nous vous informons par une requête GET envoyée à l'URL que vous avez spécifiée vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête. exemple : http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Remarque : les caractères spéciaux de pingback_url seront encodés pour URL ; par exemple, le caractère # sera encodé en %23 en savoir plus dans notre centre d'aide

      • postback_data
        Type: string

        type de données de postback_url champ facultatif correspond au type de données qui sera envoyé à votre serveur valeurs possibles : advanced

      • postback_url
        Type: string

        URL d'envoi des résultats de la tâche champ facultatif une fois la tâche terminée, nous enverrons une requête POST avec ses résultats compressés au format gzip à l'adresse postback_url que vous avez spécifiée vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête. exemple : http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Remarque : les caractères spéciaux de postback_url seront encodés pour URL ; par exemple, le caractère # sera encodé en %23 en savoir plus dans notre centre d'aide

      • priority
        Type: integer

        priorité de la tâche champ facultatif peut prendre les valeurs suivantes : 1 – priorité d'exécution normale (définie par défaut) 2 – priorité d'exécution élevée Les tâches à priorité d'exécution élevée sont facturées en supplément. le coût peut être calculé sur la page Pricing.

      • product_id
        Type: string

        identifiant unique de produit sur Google Shopping champ facultatif nous recommandons d'indiquer product_id avec data_docid et gid pour des résultats optimaux ; vous pouvez obtenir cette valeur pour un produit donné en effectuant une requête distincte vers le point de terminaison Google Shopping Products exemple : 4485466949985702538 en savoir plus sur ce paramètre dans ce guide du centre d'aide

      • se_domain
        Type: string

        domaine du moteur de recherche champ facultatif nous choisissons automatiquement le domaine du moteur de recherche pertinent en fonction de la localisation et de la langue que vous indiquez vous pouvez toutefois définir un domaine de moteur de recherche personnalisé dans ce champ exemple : google.co.uk, google.com.au, google.de, etc.

      • tag
        Type: string

        identifiant de tâche défini par l'utilisateur champ facultatif la limite est de 255 caractères vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat vous trouverez la valeur tag spécifiée dans l'objet data de la réponse

      Objet vide
      Objet vide
Réponses
  • 200
    Type: object

    Réponse réussie

    • cost
      Type: number

      coût total des tâches, USD

    • status_code
      Type: integer

      code d'état général vous pouvez trouver la liste complète des codes de réponse ici Remarque : nous recommandons vivement de concevoir un système pour gérer les conditions exceptionnelles ou d'erreur associées

    • status_message
      Type: string

      message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

    • tasks
      Type: array string[]

      tableau de tâches

    • tasks_count
      Type: integer

      le nombre de tâches dans le tableau tasks

    • tasks_error
      Type: integer

      le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

    • tasks.cost
      Type: number

      coût de la tâche, USD

    • tasks.data
      Type: object

      contient les mêmes paramètres que ceux spécifiés dans la requête POST

    • tasks.id
      Type: string

      identifiant unique de la tâche dans notre système au format d'identifiant unique universel (UUID)

    • tasks.path
      Type: array string[]

      chemin de l'URL

    • tasks.result
      Type: array string[]

      tableau de résultats dans ce cas, la valeur sera null

    • tasks.result_count
      Type: integer

      nombre d'éléments dans le tableau de résultats

    • tasks.status_code
      Type: integer

      code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000

    • tasks.status_message
      Type: string

      message d'information de la tâche

    • tasks.time
      Type: string

      temps d'exécution, en secondes

    • time
      Type: string

      temps d'exécution, en secondes

    • version
      Type: string

      la version actuelle de l'API

    application/json
  • 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
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