REST Resource: accounts.promotions

Ressource: Promotion

Représente une promotion. Pour en savoir plus, consultez les articles suivants.

Les attributs d'entrée requis pour réussir les contrôles de validation des données sont principalement définis ci-dessous:

Une fois que vous avez inséré une promotion et que vous l'avez modifiée, plusieurs minutes peuvent s'écouler avant que la promotion finale puisse être récupérée.

Représentation JSON 
{
  "name": string,
  "promotionId": string,
  "contentLanguage": string,
  "targetCountry": string,
  "redemptionChannel": [
    enum (RedemptionChannel)
  ],
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "promotionStatus": {
    object (PromotionStatus)
  },
  "versionNumber": string
}
Champs
name

string

Identifiant. Nom de la promotion. Format : accounts/{account}/promotions/{promotion}
promotionId

string

Obligatoire. Identifiant promotion fourni par l'utilisateur pour identifier la promotion de manière unique. Respectez les exigences minimales pour éviter que vos promotions soient refusées.
contentLanguage

string

Obligatoire. Code de langue ISO 639-1 à deux lettres pour la promotion.

Les promotions ne sont disponibles que pour certaines langues.
targetCountry

string

Obligatoire. Pays cible utilisé dans l'identifiant unique. Représenté par un code CLDR.

Les promotions ne sont disponibles que dans certains pays. Fiches gratuites et annonces Shopping Annonces produits en magasin
redemptionChannel[]

enum (RedemptionChannel)

Obligatoire. Canal d'utilisation de la promotion. Veuillez indiquer au moins un canal.
dataSource

string

Uniquement en sortie. Source de données principale de la promotion.
attributes

object (Attributes)

Facultatif. Liste des attributs de la promotion.
customAttributes[]

object (CustomAttribute)

Facultatif. Liste d'attributs personnalisés (fournis par le marchand). Elle peut également être utilisée 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 envoyer des attributs qui ne sont pas explicitement présentés par l'API.
promotionStatus

object (PromotionStatus)

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

string (int64 format)

Facultatif. Représente la version existante (fraîcheur) de la promotion, qui peut être utilisée pour conserver le bon ordre lorsque plusieurs mises à jour sont effectuées en même temps.

Si cette règle est définie, l'insertion n'est pas possible lorsque le numéro de version est inférieur à celui de la promotion existante. La réinsertion (par exemple, actualiser la promotion après 30 jours) peut être effectuée avec l'versionNumber actuel.

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

RedemptionChannel

Canal d'une promotion.

Enums
REDEMPTION_CHANNEL_UNSPECIFIED Indique que la chaîne n'est pas spécifiée.
IN_STORE Indique que la chaîne est disponible dans la boutique. Identique au canal local utilisé pour products.
ONLINE Indique que la chaîne est en ligne.

Attributs

Attributs.

Représentation JSON 
{
  "productApplicability": enum (ProductApplicability),
  "offerType": enum (OfferType),
  "genericRedemptionCode": string,
  "longTitle": string,
  "couponValueType": enum (CouponValueType),
  "promotionDestinations": [
    enum (DestinationEnum)
  ],
  "itemIdInclusion": [
    string
  ],
  "brandInclusion": [
    string
  ],
  "itemGroupIdInclusion": [
    string
  ],
  "productTypeInclusion": [
    string
  ],
  "itemIdExclusion": [
    string
  ],
  "brandExclusion": [
    string
  ],
  "itemGroupIdExclusion": [
    string
  ],
  "productTypeExclusion": [
    string
  ],
  "minimumPurchaseAmount": {
    object (Price)
  },
  "minimumPurchaseQuantity": string,
  "limitQuantity": string,
  "limitValue": {
    object (Price)
  },
  "percentOff": string,
  "moneyOffAmount": {
    object (Price)
  },
  "getThisQuantityDiscounted": string,
  "freeGiftValue": {
    object (Price)
  },
  "freeGiftDescription": string,
  "freeGiftItemId": string,
  "promotionEffectiveTimePeriod": {
    object (Interval)
  },
  "promotionDisplayTimePeriod": {
    object (Interval)
  },
  "storeApplicability": enum (StoreApplicability),
  "storeCodesInclusion": [
    string
  ],
  "storeCodesExclusion": [
    string
  ],
  "promotionUrl": string
}
Champs
productApplicability

enum (ProductApplicability)

Obligatoire. Applicabilité de la promotion à tous les produits ou uniquement à des produits spécifiques.
offerType

enum (OfferType)

Obligatoire. Type de la promotion. Utilisez cet attribut pour indiquer si les clients ont besoin d'un code promotionnel pour bénéficier de votre promotion.
genericRedemptionCode

string

Facultatif. Code promotionnel générique pour la promotion. À utiliser avec le champ offerType et doit respecter les conditions minimales requises.
longTitle

string

Obligatoire. Titre long de la promotion
couponValueType

enum (CouponValueType)

Obligatoire. L'attribut coupon value type (type de valeur de bon de réduction)] pour indiquer le type de promotion que vous proposez. Selon le type de valeur de bon de réduction sélectionnée, certains attributs sont obligatoires.
promotionDestinations[]

enum (DestinationEnum)

Obligatoire. Liste des destinations où la promotion s'applique. Si vous ne spécifiez pas de destination en incluant une valeur acceptée dans votre source de données, votre promotion s'affichera par défaut dans les annonces Shopping et les fiches sans frais.

Vous avez peut-être déjà envoyé les valeurs suivantes en tant que destinations pour vos produits: Shopping Actions, Inventaire sur propriétés Google et Inventaire local sur propriétés Google. Pour représenter ces valeurs, utilisez FREE_LISTINGS, FREE_LOCAL_LISTINGS, LOCAL_INVENTORY_ADS. Pour en savoir plus, consultez Destination de la promotion
itemIdInclusion[]

string

Facultatif. Filtrez les produits par ID de l'article pour la promotion. Les attributs de filtres de produits ne s'appliquent que lorsque l'attribut produits concernés par la promotion productApplicability est défini sur specific_products.
brandInclusion[]

string

Facultatif. Filtrez les produits par marque pour la promotion. Les attributs de filtres de produits ne s'appliquent que lorsque l'attribut produits concernés par la promotion productApplicability est défini sur specific_products.
itemGroupIdInclusion[]

string

Facultatif. Filtrez les produits par identifiant de groupe d'articles pour la promotion. Les attributs de filtres de produits ne s'appliquent que lorsque l'attribut produits concernés par la promotion [productApplicability] est défini sur specific_products.
productTypeInclusion[]

string

Facultatif. Filtrez les produits par type de produit pour la promotion. Les attributs de filtres de produits ne s'appliquent que lorsque l'attribut produits concernés par la promotion productApplicability est défini sur specific_products.
itemIdExclusion[]

string

Facultatif. Filtrez les produits par exclusion d'ID d'article pour la promotion. Les attributs de filtres de produits ne s'appliquent que lorsque l'attribut produits concernés par la promotion productApplicability est défini sur specific_products.
brandExclusion[]

string

Facultatif. Filtrez les produits par exclusion de marques pour la promotion. Les attributs de filtres de produits ne s'appliquent que lorsque l'attribut produits concernés par la promotion productApplicability est défini sur specific_products.
itemGroupIdExclusion[]

string

Facultatif. Filtre de produits par identifiant de groupe d'articles. Les attributs de filtres de produits ne s'appliquent que lorsque l'attribut produits concernés par la promotion productApplicability est défini sur specific_products.
productTypeExclusion[]

string

Facultatif. Filtrez les produits par exclusion de type de produit pour la promotion. Les attributs de filtres de produits ne s'appliquent que lorsque l'attribut produits concernés par la promotion productApplicability est défini sur specific_products.
minimumPurchaseAmount

object (Price)

Facultatif. Montant minimal d'achat associé à la promotion.
minimumPurchaseQuantity

string (int64 format)

Facultatif. Quantité minimale à acheter pour la promotion.
limitQuantity

string (int64 format)

Facultatif. Quantité maximale par commande pour la promotion.
limitValue

object (Price)

Facultatif. Prix maximal du produit pour la promotion.
percentOff

string (int64 format)

Facultatif. Pourcentage de remise sans frais dans la promotion.
moneyOffAmount

object (Price)

Facultatif. Montant de la remise proposée dans le cadre de la promotion.
getThisQuantityDiscounted

string (int64 format)

Facultatif. Nombre d'articles à prix réduit dans la promotion. L'attribut est défini lorsque couponValueType est égal à buy_m_get_n_money_off ou buy_m_get_n_percent_off.
freeGiftValue

object (Price)

Facultatif. Valeur du cadeau pour la promotion.
freeGiftDescription

string

Facultatif. Description du cadeau sans frais pour la promotion.
freeGiftItemId

string

Facultatif. Identifiant du cadeau sans frais pour la promotion.
promotionEffectiveTimePeriod

object (Interval)

Obligatoire. Représentation par TimePeriod des dates d'entrée en vigueur de la promotion. Cet attribut indique que la promotion peut être testée sur votre boutique en ligne pendant cette période.
promotionDisplayTimePeriod

object (Interval)

Facultatif. Représentation TimePeriod des dates de diffusion de la promotion. Cet attribut permet d'indiquer la période au cours de laquelle la promotion sera diffusée sur Google.fr et dans les annonces Shopping. Si l'attribut période d'affichage de la promotion promotionDisplayTimePeriod n'est pas spécifié, la période de validité de la promotion promotionEffectiveTimePeriod détermine la date et la période au cours desquelles la promotion sera diffusée sur Google.com et dans les annonces Shopping.
storeApplicability

enum (StoreApplicability)

Facultatif. Indique si la promotion s'applique à tous les magasins ou uniquement à certains magasins. Les promotions des annonces produits en magasin génèrent une erreur si aucun magasin n'est concerné. Une erreur INVALID_ARGUMENT est générée si storeApplicability est défini sur ALL_STORES, et que storeCodesInclusion ou score_code_exclusion est défini sur une valeur.
storeCodesInclusion[]

string

Facultatif. Codes de magasin à inclure pour la promotion. Les attributs de filtre de magasins ne s'appliquent que lorsque l'attribut storeApplicability est défini sur specific_stores.

Code de magasin (identifiant de magasin indiqué dans votre fiche d'établissement) du magasin physique dans lequel le produit est vendu. Pour en savoir plus, consultez les spécifications des données d'inventaire de produits en magasin.
storeCodesExclusion[]

string

Facultatif. Codes de magasin à exclure de la promotion. Les attributs de filtre de magasins ne s'appliquent que lorsque l'attribut storeApplicability est défini sur specific_stores.
promotionUrl

string

Facultatif. URL de la page du site du marchand sur laquelle la promotion est diffusée. Les promotions des annonces produits en magasin génèrent une erreur si aucun promotionUrl n'est inclus. L'URL permet de confirmer que la promotion est valide et peut être utilisée.

ProductApplicability

Produit ou liste de produits auxquels la promotion s'applique.

Enums
PRODUCT_APPLICABILITY_UNSPECIFIED Les produits auxquels la promotion s'applique sont inconnus.
ALL_PRODUCTS Applicable à tous les produits.
SPECIFIC_PRODUCTS Applicable à un seul produit ou à une seule liste de produits.

OfferType

Type d'offre d'une promotion.

Enums
OFFER_TYPE_UNSPECIFIED Type d'offre inconnu.
NO_CODE Type d'offre sans code
GENERIC_CODE Type d'offre avec un code. Un code promotionnel générique est obligatoire pour la promotion lorsque offerType = GENERIC_CODE.

CouponValueType

Type de valeur de bon de réduction d'une promotion.

Enums
COUPON_VALUE_TYPE_UNSPECIFIED Indique que le type de valeur du bon de réduction n'est pas spécifié.
MONEY_OFF Type de valeur de remise.
PERCENT_OFF Type de valeur de pourcentage de réduction.
BUY_M_GET_N_MONEY_OFF N de remise pour M produits achetés et un type de valeur de bon de réduction de N. minimumPurchaseQuantity et getThisQuantityDiscounted doivent être présents. moneyOffAmount doit également être présent.
BUY_M_GET_N_PERCENT_OFF N pour cent de remise sur le type de valeur d'un bon de réduction pour M produits achetés. minimumPurchaseQuantity et getThisQuantityDiscounted doivent être présents. percent_off_percentage doit également être présent.
BUY_M_GET_MONEY_OFF Bénéficiez d'une remise pour M produits achetés. minimumPurchaseQuantity et moneyOffAmount doivent être présents.
BUY_M_GET_PERCENT_OFF Bénéficiez d'une remise pour M produits achetés. minimumPurchaseQuantity et percent_off_percentage doivent être présents.
FREE_GIFT Cadeau avec description uniquement.
FREE_GIFT_WITH_VALUE Cadeau à valeur monétaire.
FREE_GIFT_WITH_ITEM_ID Cadeau avec ID de l'article.
FREE_SHIPPING_STANDARD Type de valeur d'un bon de réduction standard pour livraison sans frais.
FREE_SHIPPING_OVERNIGHT Type de valeur pour le bon de réduction "Livraison gratuite sous 24h".
FREE_SHIPPING_TWO_DAY Type de valeur "Bon de réduction Livraison gratuite sous 48h".

DestinationEnum

Valeurs de destination.

Enums
DESTINATION_ENUM_UNSPECIFIED Non spécifié.
SHOPPING_ADS Annonces Shopping :
DISPLAY_ADS Annonces display :
LOCAL_INVENTORY_ADS Les annonces produits en magasin :
FREE_LISTINGS Free listings [Fiches gratuites] :
FREE_LOCAL_LISTINGS Fiches produit locales gratuites :
YOUTUBE_SHOPPING YouTube Shopping :

StoreApplicability

Codes de magasin ou liste des codes de magasin auxquels la promotion s'applique. Uniquement pour les promotions des annonces produits en magasin.

Enums
STORE_APPLICABILITY_UNSPECIFIED Les codes de magasin auxquels la promotion s'applique sont inconnus.
ALL_STORES La promotion s'applique à tous les magasins.
SPECIFIC_STORES La promotion ne s'applique qu'aux magasins spécifiés.

PromotionStatus

État de la promotion.

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

object (DestinationStatus)

Uniquement en sortie. Destinations prévues de la promotion.
itemLevelIssues[]

object (ItemLevelIssue)

Uniquement en sortie. Liste des problèmes associés à la promotion.
creationDate

string (Timestamp format)

Uniquement en sortie. Date de création de la promotion au format ISO 8601: date, heure et décalage (par exemple, 2020-01-02T09:00:00+01:00 ou 2020-01-02T09:00:00Z)
lastUpdateDate

string (Timestamp format)

Uniquement en sortie. Date à laquelle l'état de la promotion a été mis à jour pour la dernière fois au format ISO 8601: date, heure et décalage (par exemple, 2020-01-02T09:00:00+01:00 ou 2020-01-02T09:00:00Z)

DestinationStatus

État de la destination spécifiée.

Représentation JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "status": enum (State)
}
Champs
reportingContext

enum (ReportingContextEnum)

Uniquement en sortie. Nom de la destination de la promotion.
status

enum (State)

Uniquement en sortie. État de la destination spécifiée.

État

État actuel de la promotion.

Enums
STATE_UNSPECIFIED État de promotion inconnu.
IN_REVIEW La promotion est en cours d'examen.
REJECTED La promotion est refusée.
LIVE La promotion a été approuvée et active.
STOPPED Le marchand a interrompu la promotion.
EXPIRED La promotion n'est plus active.
PENDING La promotion n'est pas interrompue et tous les examens ont été approuvés, mais la date d'activation n'est pas encore passée.

ItemLevelIssue

Problème associé à la promotion.

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

Uniquement en sortie. Code d'erreur du problème
severity

enum (Severity)

Uniquement en sortie. Impact de ce problème sur la diffusion de la promotion
resolution

string

Uniquement en sortie. Indique si le problème peut être résolu par le marchand.
attribute

string

Uniquement en sortie. Nom de l'attribut, si le problème est causé par un seul attribut.
reportingContext

enum (ReportingContextEnum)

Uniquement en sortie. Destination à laquelle le problème s'applique.
description

string

Uniquement en sortie. Une brève description du problème en anglais.
detail

string

Uniquement en sortie. Une description détaillée du problème en anglais.
documentation

string

Uniquement en sortie. URL d'une page Web qui vous aide à résoudre ce problème.
applicableCountries[]

string

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

Gravité

Gravité du problème

Enums
SEVERITY_UNSPECIFIED Non spécifié.
NOT_IMPACTED Il s'agit d'un avertissement qui n'a pas d'incidence directe sur la promotion.
DEMOTED La promotion est rétrogradée et ses performances dans les résultats de recherche sont probablement limitées
DISAPPROVED Un problème entraîne le refus de la promotion.

Méthodes

get

 Récupère la promotion à partir de votre compte Merchant Center.

insert

 Insère une promotion pour votre compte Merchant Center.

list

 Liste les promotions dans votre compte Merchant Center.