- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Importe des données produit dans votre compte Merchant Center. Si une entrée associée aux mêmes valeurs contentLanguage, offerId et dataSource existe déjà, cette méthode la remplace.
Après l'insertion, la mise à jour ou la suppression d'un produit saisi, plusieurs minutes peuvent s'écouler avant que le produit traité ne puisse être récupéré.
Requête HTTP
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
parent |
Obligatoire. Compte dans lequel ce produit sera inséré. Format: accounts/{account} |
Paramètres de requête
Paramètres | |
---|---|
dataSource |
Obligatoire. Nom de la source de données produit principale ou supplémentaire. Si le produit existe déjà et que la source de données fournie est différente, il est déplacé vers une nouvelle source de données. Format : |
Corps de la requête
Le corps de la requête contient une instance de ProductInput
.
Corps de la réponse
Cette ressource représente les données d'entrée que vous envoyez pour un produit, et non le produit traité que vous voyez dans Merchant Center, dans les annonces Shopping ou sur les surfaces Google. Les entrées produit, les règles et les données des sources de données supplémentaires sont combinées pour créer le [produit][google.shopping.content.bundles.Products.Product] traité.
Les attributs d'entrée de produit obligatoires pour réussir les contrôles de validation des données sont principalement définis dans les spécifications des données produit.
Les attributs suivants sont obligatoires: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] et [offerId][google.shopping.content.bundles.Products.offer_id].
Après l'insertion, la mise à jour ou la suppression d'un produit saisi, plusieurs minutes peuvent s'écouler avant que le produit traité ne puisse être récupéré.
Tous les champs de la saisie du produit et de ses sous-messages correspondent au nom en anglais de l'attribut correspondant dans la spécification du secteur, à l'exception de quelques exceptions.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{ "name": string, "product": string, "channel": enum ( |
Champs | |
---|---|
name |
Identifiant. Nom du produit saisi. Format : |
product |
Uniquement en sortie. Nom du produit traité. Format : |
channel |
Obligatoire. Immuable. Canal du produit. |
offerId |
Obligatoire. Immuable. Identifiant unique du produit. Il en va de même pour le produit saisi et le produit traité. Les espaces blancs au début et à la fin sont supprimés, et plusieurs espaces blancs sont remplacés par un seul espace blanc lors de l'envoi. Pour en savoir plus, consultez les spécifications des données produit. |
contentLanguage |
Obligatoire. Immuable. Code de langue ISO 639-1 à deux lettres du produit. |
feedLabel |
Obligatoire. Immuable. Libellé du flux du produit. |
attributes |
Facultatif. Liste des attributs de produit. |
customAttributes[] |
Facultatif. Liste d'attributs personnalisés (fournis par le marchand). Elle peut également être utilisée pour envoyer n'importe quel attribut de la spécification des données sous sa forme générique (par exemple, |
versionNumber |
Facultatif. Représente la version existante (fraîcheur) du produit, qui peut être utilisée pour préserver le bon ordre lorsque plusieurs mises à jour sont effectuées en même temps. Si cette règle est définie, l'insertion est bloquée lorsque le numéro de version est inférieur à celui actuel du produit existant. La réinsertion (par exemple, actualiser le produit après 30 jours) peut être effectuée avec la Compatible uniquement avec les insertions dans les sources de données principales. Si l'opération est empêchée, l'exception annulée est générée. |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/content
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.