REST Resource: accounts.products

Ressource : Product

Produit traité, créé à partir de plusieurs product inputs après l'application de règles et de sources de données supplémentaires. Ce produit traité correspond à celui qui s'affiche dans votre compte Merchant Center, dans les annonces Shopping et sur les autres surfaces Google. Chaque produit est créé à partir d'une seule entrée de produit de la source de données principale et de plusieurs entrées de la source de données supplémentaire. 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é mis à jour puisse être récupéré.

Tous les champs du produit traité et de ses sous-messages correspondent au nom de l'attribut correspondant dans les spécifications des données produit, à quelques exceptions près.

Représentation JSON
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Champs
name

string

Nom du produit. Format : "{product.name=accounts/{account}/products/{product}}", où la dernière section product se compose de quatre parties : channel~contentLanguage~feedLabel~offerId. Exemple de nom de produit : "accounts/123/products/online~en~US~sku123".

channel

enum (ChannelEnum)

Uniquement en sortie. Canal du produit.

offerId

string

Uniquement en sortie. 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

Uniquement en sortie. Code de langue ISO 639-1 à deux lettres pour le produit.

feedLabel

string

Uniquement en sortie. Libellé du flux pour le produit.

dataSource

string

Uniquement en sortie. Source de données principale du produit.

attributes

object (Attributes)

Uniquement en sortie. Liste des attributs de produit.

customAttributes[]

object (CustomAttribute)

Uniquement en sortie. 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.

productStatus

object (ProductStatus)

Uniquement en sortie. État d'un produit, problèmes de validation des données, c'est-à-dire informations sur un produit calculées de manière asynchrone.

versionNumber

string (int64 format)

Uniquement en sortie. 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.

ProductStatus

État d'un produit, problèmes de validation des données, c'est-à-dire informations sur un produit calculées de manière asynchrone.

Représentation JSON
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Champs
destinationStatuses[]

object (DestinationStatus)

Destinations prévues pour le produit

itemLevelIssues[]

object (ItemLevelIssue)

Liste de tous les problèmes associés au produit.

creationDate

string (Timestamp format)

Date de création de l'article, au format ISO 8601.

lastUpdateDate

string (Timestamp format)

Date de la dernière mise à jour de l'article, au format ISO 8601.

googleExpirationDate

string (Timestamp format)

Date d'expiration de l'article, au format ISO 8601.

DestinationStatus

État de destination de l'état du produit.

Représentation JSON
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Champs
reportingContext

enum (ReportingContextEnum)

Nom du contexte de création de rapports.

approvedCountries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) dans lesquels l'offre est approuvée.

pendingCountries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) dans lesquels l'offre est en attente d'approbation.

disapprovedCountries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) dans lesquels l'offre est refusée.

ItemLevelIssue

ItemLevelIssue de l'état du produit.

Représentation JSON
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Champs
code

string

Code d'erreur du problème

severity

enum (Severity)

Indique comment ce problème affecte la diffusion de l'offre

resolution

string

Indique si le problème peut être résolu par le marchand

attribute

string

Si le problème est causé par un attribut unique, nom de cet attribut

reportingContext

enum (ReportingContextEnum)

Contexte des rapports auquel le problème s'applique.

description

string

Description courte du problème en anglais

detail

string

Description détaillée du problème en anglais

documentation

string

URL d'une page Web d'aide pour résoudre ce problème

applicableCountries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) auxquels le problème s'applique pour l'offre.

Gravité

Indique comment le problème affecte la diffusion du produit

Enums
SEVERITY_UNSPECIFIED Non spécifié.
NOT_IMPACTED Il s'agit d'un avertissement qui n'a aucune incidence directe sur le produit.
DEMOTED Le produit est rétrogradé et ses performances dans les résultats de recherche sont probablement limitées.
DISAPPROVED Le produit est refusé.

Méthodes

get

Récupère le produit traité à partir de votre compte Merchant Center.

list

Répertorie les produits traités dans votre compte Merchant Center.