Method: accounts.productInputs.insert

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

string

Obligatoire. Compte dans lequel ce produit sera inséré. Format: accounts/{account}

Paramètres de requête

Paramètres
dataSource

string

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 : accounts/{account}/dataSources/{datasource}.

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 (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
Champs
name

string

Identifiant. Nom du produit saisi. Format : "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Uniquement en sortie. Nom du produit traité. Format : "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Obligatoire. Immuable. Canal du produit.
offerId

string

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

string

Obligatoire. Immuable. Code de langue ISO 639-1 à deux lettres du produit.
feedLabel

string

Obligatoire. Immuable. Libellé du flux du produit.
attributes

object (Attributes)

Facultatif. Liste des attributs de produit.
customAttributes[]

object (CustomAttribute)

Facultatif. Liste d'attributs personnalisés (fournis par le marchand). Vous pouvez également l'utiliser pour envoyer tout attribut des spécifications des données sous sa forme générique (par exemple, { "name": "size type", "value": "regular" }). Cela est utile pour indiquer des attributs qui ne sont pas explicitement indiqués par l'API, tels que les attributs supplémentaires utilisés pour Acheter sur Google. Le nombre maximal de caractères autorisé pour chaque attribut personnalisé est de 10 240 (correspond à la somme des caractères du nom et de la valeur). Vous pouvez définir jusqu'à 2 500 attributs personnalisés par produit, d'une taille totale de 102,4 ko. Les traits de soulignement dans les noms d'attributs personnalisés sont remplacés par des espaces lors de l'insertion.
versionNumber

string (int64 format)

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 versionNumber actuelle.

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.