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 du 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 de produit.

customAttributes[]

object (CustomAttribute)

Uniquement en sortie. Liste d'attributs personnalisés (fournis par le CSS). Elle peut également être utilisée pour envoyer n'importe quel attribut des spécifications du flux 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.

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 du produit 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
}
Champs
lowPrice

object (Price)

Prix bas du produit du CSS

highPrice

object (Price)

Prix élevé du produit du CSS

headlineOfferPrice

object (Price)

Prix de l'offre principale du produit CSS.

headlineOfferShippingPrice

object (Price)

Prix de l'offre principale du produit du 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 articles vestimentaires. Vous pouvez indiquer deux types de tailles maximum (voir [https://support.google.com/merchants/answer/6324497](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 les unités fournies. 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 les unités fournies. La valeur doit être comprise entre 0 (exclu) et 3 000 (inclus).

productHighlights[]

string

Liste à 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 donné.

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 de l'élément peut prendre plus de deux jours à 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 l'achat d'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 pour un produit.

numberOfOffers

string (int64 format)

Nombre de produits du CSS.

headlineOfferCondition

string

État de l'offre principale.

title

string

Intitulé de l'article

description

string

Description de l'article.

brand

string

Attributs associé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 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é de 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.

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 micros (1 million de micros équivaut à l'unité standard de la devise, par exemple, 1 USD = 1 000 000 micros).

currencyCode

string

Devise du prix à l'aide d'acronymes à 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 un produit.

attributeName

string

Nom des informations détaillées 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 pondération peut avoir une précision maximale de 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 la 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 d'efficacité énergétique dans la base de données du Registre européen de l'étiquetage énergétique (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 énergétiques de 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 énergétiques 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 payer au préalable.

HeadlineOfferSubscriptionCost

Coût de l'abonnement du produit.

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

enum (SubscriptionPeriod)

Type de durée d'abonnement. Les valeurs acceptées sont: * "month" * "year"

periodLength

string (int64 format)

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

amount

object (Price)

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

SubscriptionPeriod

Période d'abonnement du 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 de 1 mois.
YEAR Indique que la période d'abonnement est d'un an.

CustomAttribute

Message représentant des attributs personnalisés. Un seul des éléments 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 être vide.

name

string

Nom de l'attribut.

value

string

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

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 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) dans lesquels le produit CSS est approuvé.

pendingCountries[]

string

Liste des codes pays (ISO 3166-1 alpha-2) pour lesquels l'approbation du produit CSS est en attente.

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 pour le 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.