REST Resource: accounts.productInputs

Ressource: ProductInput

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 plates-formes Google. Les entrées produit, les règles et les données de la source de données supplémentaires sont combinées pour créer l'Product traitée.

Les attributs de saisie de produits obligatoires pour réussir les vérifications de validation des données sont principalement définis dans les spécifications des données produit.

Les attributs suivants sont obligatoires: feedLabel, contentLanguage et offerId.

Après avoir inséré, mis à jour ou supprimé une entrée de produit, il peut s'écouler plusieurs minutes avant que le produit traité puisse être récupéré.

Tous les champs de l'entrée produit et de ses sous-messages correspondent au nom anglais de l'attribut correspondant dans la spécification du secteur, à quelques exceptions près.

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 de l'entrée du produit. Format : "{productinput.name=accounts/{account}/productInputs/{productinput}}", où la dernière section productinput se compose de quatre parties : channel~contentLanguage~feedLabel~offerId. Exemple de nom d'entrée de produit : "accounts/123/productInputs/online~en~US~sku123".
product

string

Uniquement en sortie. Nom du produit transformé. 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 l'entrée du produit et le produit transformé. Les espaces blancs au début et à la fin sont supprimés et plusieurs espaces blancs sont remplacés par un seul et unique espace blanc lors de la soumission. Pour en savoir plus, consultez les spécifications des données produit.
contentLanguage

string

Obligatoire. Immuable. Code de langue ISO 639-1 à deux lettres pour le 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). Elle peut également être utilisée pour envoyer n'importe quel attribut des spécifications des données sous sa forme générique (par exemple, { "name": "size type", "value": "regular" }). Cela est utile pour envoyer des attributs non 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és pour chaque attribut personnalisé est de 10 240 (correspond à la somme des caractères du nom et de la valeur). Vous pouvez définir 2 500 attributs personnalisés au maximum par produit, avec 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 conserver l'ordre correct lorsque plusieurs mises à jour sont effectuées en même temps.

Si cet argument est défini, l'insertion est empêchée lorsque le numéro de version est inférieur au numéro de version actuel du produit existant. La réinsertion (par exemple, la mise à jour du produit après 30 jours) peut être effectuée avec l'versionNumber actuelle.

Compatible uniquement avec les insertions dans des sources de données principales.

Si l'opération est empêchée, l'exception "aborted" est générée.

Méthodes

delete

 Supprime une entrée de produit de votre compte Merchant Center.

insert

 Importe une entrée produit dans votre compte Merchant Center.