Configurer les tâches Google Shopping Sellers
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches Google Shopping Sellers
Met en file d'attente la liste des vendeurs proposant un produit Google Shopping et renvoie un id de tâche. 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_sellers_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.
- Type: array (object | null)[]
- additionalType: object | null
_specifications objet contenant des paramètres d'URL supplémentaires
vous pouvez obtenir des informations supplémentaires sur le produit à l'aide de l'objet"additional_specifications, que vous pouvez obtenir en effectuant une requête distincte vers le point de terminaison Google Shopping Products
exemple :"additional_specifications": {
"eto": "16157121050167572763_0"
}- propertyType: string | null
Name
- dataType: string
_docid identifiant unique de l'élément de données SERP
champ obligatoire siproduct_idougidn'est pas indiqué
nous recommandons d'indiquerdata_docidavecproduct_idetgidpour 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 - depthType: integer | null
profondeur d'analyse
champ facultatif
nombre de résultats à récupérer depuis le SERP Google Shopping
valeur par défaut :10
valeur maximale :200
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 Pricing - getType: boolean | null
_shops _on _google inclure les boutiques « buy on Google »
champ facultatif
si la valeur esttrue, la réponse contiendra la liste des vendeurs qui permettent d'acheter un produit donné directement sur Google
Remarque : si la valeur esttrue, le coût d'une tâche sera doublé - gidType: string
identifiant global du produit sur Google Shopping
champ obligatoire siproduct_idoudata_docidn'est pas indiqué
nous recommandons d'indiquergidavecproduct_idetdata_docidpour 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 - languageType: string
_code code de langue
champ obligatoire si vous ne spécifiez paslanguage_name
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_name
vous pouvez obtenir la liste des langues Google Shopping disponibles avec leurlanguage_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/merchant/google/languages
exemple :en - languageType: string
_name nom complet de la langue
champ obligatoire si vous ne spécifiez paslanguage_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_code
vous pouvez obtenir la liste des langues Google Shopping disponibles avec leurlanguage_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/merchant/google/languages
exemple :English - locationType: integer
_code code d'emplacement
champ obligatoire si vous ne spécifiez paslocation_namenilocation_coordinate
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_namenilocation_coordinate
vous pouvez obtenir la liste des emplacements Google Shopping disponibles avec leurlocation_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/merchant/google/locations
exemple :2840 - locationType: string
_coordinate coordonnées GPS d'un emplacement
champ obligatoire si vous ne spécifiez paslocation_namenilocation_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_namenilocation_code
le paramètrelocation_coordinatedoit ê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 - locationType: string
_name nom complet de l'emplacement
champ obligatoire si vous ne spécifiez paslocation_codenilocation_coordinate
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_codenilocation_coordinate
vous pouvez obtenir la liste des emplacements Google Shopping disponibles avec leurlocation_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/merchant/google/locations
exemple :London,England,United Kingdom - pingbackType: string | null
_url URL de notification d'une tâche terminée
champ facultatif
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
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depingback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - postbackType: string | null
_data - postbackType: string | null
_url 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 formatgzipà l'adressepostback_urlque vous avez spécifiée
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depostback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - priorityType: integer | null
- productType: string
_id identifiant unique du produit sur Google Shopping
champ obligatoire sidata_docidougidn'est pas indiqué
nous recommandons d'indiquerproduct_idavecdata_docidetgidpour 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 :4485466949985702538
en savoir plus sur le paramètre dans ce guide du centre d'aide - pvfType: string | null
filtre de variantes de produit sur Google Shopping
champ facultatif
paramètre de l'URL Google Shopping qui définit le filtrage facultatif des variantes de produit ;
exemple :Eg4iBWNvbG9yKgV3aGl0ZRISIgxwYWNrYWdlIHNpemUqAjE0EgoiBHNpemUqAnhs - seType: string | null
_domain 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. - tagType: string | null
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 valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskPostTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: object | null
tableau de résultats
dans ce cas, la valeur seranull - resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/sellers/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"product_id": "1113158713975221117"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": null
}
]
}