REST Resource: accounts.cssProducts

Ressource : CssProduct

Produit CSS traité.

Représentation JSON
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Champs
name

string

Nom du produit CSS. Format : "accounts/{account}/cssProducts/{css_product}"

rawProvidedId

string

Uniquement en sortie. Identifiant brut unique de votre 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.

attributes

object (Attributes)

Uniquement en sortie. Liste des attributs du produit.

customAttributes[]

object (CustomAttribute)

Uniquement en sortie. Liste d'attributs personnalisés (fournis par la CSS). Elle peut également être utilisée pour soumettre tout attribut des spécifications du flux de forme générique (par exemple, { "name": "size type", "value": "regular" }). Cela est utile pour soumettre des attributs non explicitement indiqués par l'API, tels que les attributs supplémentaires utilisés pour Acheter sur Google.

cssProductStatus

object (CssProductStatus)

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.

Attributs

Attributs pour les produits CSS.

Représentation JSON
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
Champs
lowPrice

object (Price)

Prix bas du produit CSS.

highPrice

object (Price)

Prix élevé du produit CSS.

headlineOfferPrice

object (Price)

Prix principal du produit CSS.

headlineOfferShippingPrice

object (Price)

Prix principal du produit CSS.

productTypes[]

string

Catégories de l'article (formatées selon les spécifications des données produit).

sizeTypes[]

string

Coupe de l'article. Il peut être utilisé pour représenter des types de tailles combinés pour les vêtements. Vous pouvez indiquer deux types de tailles au maximum (voir type de taille).

productDetails[]

object (ProductDetail)

Spécifications techniques ou informations supplémentaires sur le produit.

productWeight

object (ProductWeight)

Poids du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 2 000 (inclus).

productLength

object (ProductDimension)

Longueur du produit dans l'unité fournie. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus).

productWidth

object (ProductDimension)

Largeur du produit dans les unités fournies. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus).

productHeight

object (ProductDimension)

Hauteur du produit dans l'unité fournie. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus).

productHighlights[]

string

Puces décrivant les points forts les plus pertinents d'un produit.

certifications[]

object (Certification)

Liste des certificats revendiqués par le CSS pour le produit concerné.

expirationDate

string (Timestamp format)

Date d'expiration de l'article, telle que spécifiée lors de l'insertion, au format ISO 8601. La date d'expiration réelle est indiquée dans productstatuses sous googleExpirationDate. Elle peut être anticipée si expirationDate est trop éloignée. Remarque : La suppression effective d'un élément peut prendre deux jours ou plus à compter de la date d'expiration.

includedDestinations[]

string

Liste des destinations à inclure pour cette cible (correspond aux cases cochées dans Merchant Center). Les destinations par défaut sont toujours incluses, sauf si elles sont spécifiées dans excludedDestinations.

excludedDestinations[]

string

Liste des destinations à exclure pour cette cible (correspond aux cases non cochées dans Merchant Center).

headlineOfferInstallment

object (HeadlineOfferInstallment)

Nombre et montant des versements à payer pour un article.

headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

Nombre de périodes (mois ou années) et montant du paiement par période pour un article associé à un contrat d'abonnement.

cppAdsRedirect

string

Permet aux annonceurs de remplacer l'URL de l'article lorsque celui-ci est proposé dans le contexte d'annonces produit.

numberOfOffers

string (int64 format)

Nombre de produits CSS.

headlineOfferCondition

string

État de l'offre principale.

title

string

Intitulé de l'article

description

string

Description de l'article.

brand

string

Attributs liés au produit.[14-36] Marque de l'article.

mpn

string

Référence fabricant (MPN) de l'article.

gtin

string

Code article international (GTIN) de l'article.

googleProductCategory

string

Catégorie de Google pour l'article (voir la classification des produits Google). Lorsque vous interrogez des produits, ce champ contient la valeur fournie par l'utilisateur. Il n'existe actuellement aucun moyen de récupérer les catégories de produits Google attribuées automatiquement via l'API.

adult

boolean

Défini sur "Vrai" si l'article est destiné aux adultes.

multipack

string (int64 format)

Nombre de produits identiques dans un multipack défini par le marchand.

isBundle

boolean

Indique si l'article est un lot défini par le marchand. Un lot est un groupe personnalisé de différents produits vendus par un marchand à un prix unique.

ageGroup

string

Tranche d'âge cible de l'article.

color

string

Couleur de l'article.

gender

string

Sexe du public auquel est destiné l'article.

material

string

Matière de l'article.

pattern

string

Motif de l'article (par exemple, à pois).

size

string

Taille de l'article. Une seule valeur est autorisée. Pour les variantes de différentes tailles, insérez un produit distinct pour chaque taille avec la même valeur itemGroupId (voir [https://support.google.com/merchants/answer/6324492](définition de la taille)).

sizeSystem

string

Système d'indication de la taille. Recommandée pour les articles vestimentaires.

itemGroupId

string

Identifiant partagé pour toutes les variantes d'un même produit.

pause

string

La publication de cet élément sera temporairement suspendue.

customLabel0

string

Étiquette personnalisée 0 pour un regroupement personnalisé d'articles dans une campagne Shopping.

customLabel1

string

Étiquette personnalisée 1 pour un regroupement personnalisé d'articles dans une campagne Shopping.

customLabel2

string

Étiquette personnalisée 2 pour un regroupement personnalisé d'articles dans une campagne Shopping.

customLabel3

string

Étiquette personnalisée 3 pour un regroupement personnalisé d'articles dans une campagne Shopping.

customLabel4

string

Étiquette personnalisée 4 pour un regroupement personnalisé d'articles dans une campagne Shopping.

reviewCount

string (int64 format)

Nombre d'avis sur le produit. Obligatoire si rating est fourni. Ce champ est destiné à une fonctionnalité à venir et n'est pas encore utilisé.

minRating

string (int64 format)

Note minimale du produit. Obligatoire si rating est fourni. Ce champ est destiné à une fonctionnalité à venir et n'est pas encore utilisé.

maxRating

string (int64 format)

Note maximale du produit. Obligatoire si rating est fourni. Ce champ est destiné à une fonctionnalité à venir et n'est pas encore utilisé.

rating

number

Note moyenne du produit. La valeur doit être comprise entre minRating et maxRating, inclus. Lorsqu'elle est affichée sur la page produit, cette note est normalisée sur une échelle de 1 à 5 avec une décimale. Si vous les fournissez, reviewCount, minRating et maxRating sont également obligatoires. Ce champ est destiné à une fonctionnalité à venir et n'est pas encore utilisé.

Prix

Prix représenté sous forme de nombre et de devise.

Représentation JSON
{
  "amountMicros": string,
  "currencyCode": string
}
Champs
amountMicros

string (int64 format)

Prix représenté sous la forme d'un nombre en micro-unités (un million de micro-unités équivaut à une unité standard de la devise, par exemple, 1 USD = 1 000 000 de micro-unités).

currencyCode

string

Devise du prix, sous forme d'acronyme de trois lettres, conformément à la norme ISO 4217.

ProductDetail

Informations détaillées sur le produit.

Représentation JSON
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Champs
sectionName

string

En-tête de section utilisé pour regrouper un ensemble d'informations détaillées sur les produits.

attributeName

string

Nom de l'information détaillée sur le produit.

attributeValue

string

Valeur des informations détaillées sur le produit.

ProductWeight

Poids du produit.

Représentation JSON
{
  "value": number,
  "unit": string
}
Champs
value

number

Obligatoire. Poids représenté sous forme de nombre. La précision du poids ne peut pas dépasser quatre décimales.

unit

string

Obligatoire. Unité de poids. Les valeurs acceptées sont les suivantes : * "g" * "kg" * "oz" * "lb"

ProductDimension

Dimension du produit.

Représentation JSON
{
  "value": number,
  "unit": string
}
Champs
value

number

Obligatoire. Valeur de la dimension représentée sous forme de nombre. La valeur peut avoir une précision maximale de quatre décimales.

unit

string

Obligatoire. Unités de dimension. Les valeurs acceptées sont les suivantes : * "in" * "cm"

Certification

Certification du produit. Utilisez cet attribut pour décrire les certifications associées à un produit, telles que la classe énergétique.

Représentation JSON
{
  "name": string,
  "authority": string,
  "code": string
}
Champs
name

string

Nom de la certification. Pour le moment, la valeur la plus courante est "EPREL", qui représente les certifications dans la base de données du Registre européen de l'étiquetage énergétique des produits (EPREL) de l'UE.

authority

string

Autorité ou organisme de certification qui délivre la certification. Pour le moment, la valeur la plus courante est "EC" ou "European_Commission" pour les étiquettes énergie dans l'UE.

code

string

Code de la certification. Par exemple, pour le certificat EPREL correspondant au lien https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, le code est 123456. Le code est obligatoire pour les étiquettes énergie européennes.

HeadlineOfferInstallment

Message représentant un versement.

Représentation JSON
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
Champs
months

string (int64 format)

Nombre de versements que l'acheteur doit effectuer.

amount

object (Price)

Montant que l'acheteur doit verser chaque mois.

downpayment

object (Price)

Montant de l'acompte que l'acheteur doit verser au préalable.

HeadlineOfferSubscriptionCost

SubscriptionCost du produit.

Représentation JSON
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Champs
period

enum (SubscriptionPeriod)

Type de période d'abonnement. Les valeurs acceptées sont les suivantes : * "month" * "year"

periodLength

string (int64 format)

Nombre de périodes d'abonnement pendant lesquelles l'acheteur doit payer.

amount

object (Price)

Montant que l'acheteur doit verser pour chaque période d'abonnement.

SubscriptionPeriod

Période d'abonnement au produit.

Enums
SUBSCRIPTION_PERIOD_UNSPECIFIED Indique que la période d'abonnement n'est pas spécifiée.
MONTH Indique que la période d'abonnement est d'un mois.
YEAR Indique que la période d'abonnement est d'un an.

CustomAttribute

Message représentant des attributs personnalisés. Un seul des champs value ou groupValues ne doit pas être vide.

Représentation JSON
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Champs
groupValues[]

object (CustomAttribute)

Sous-attributs de ce groupe d'attributs. Si groupValues n'est pas vide, value doit l'être.

name

string

Nom de l'attribut.

value

string

Valeur de l'attribut. Si value n'est pas vide, groupValues doit l'être.

CssProductStatus

État du produit CSS, problèmes de validation des données, c'est-à-dire informations sur le produit CSS 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 la destination de l'état du produit.

Représentation JSON
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Champs
destination

string

Nom de la destination

approvedCountries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) où le produit CSS est approuvé.

pendingCountries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) où le produit CSS est en attente d'approbation.

disapprovedCountries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) dans lesquels le produit CSS est refusé.

ItemLevelIssue

ItemLevelIssue de l'état du produit.

Représentation JSON
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Champs
code

string

Code d'erreur du problème

servability

string

Indique comment ce problème affecte la diffusion du produit CSS.

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

destination

string

Destination concernée par le problème

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 au produit CSS.

Méthodes

get

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

list

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