Index
PromotionsService
(interface)Attributes
(message)CouponValueType
(enum)GetPromotionRequest
(message)InsertPromotionRequest
(message)ListPromotionsRequest
(message)ListPromotionsResponse
(message)OfferType
(enum)ProductApplicability
(enum)Promotion
(message)PromotionStatus
(message)PromotionStatus.DestinationStatus
(message)PromotionStatus.DestinationStatus.State
(enum)PromotionStatus.ItemLevelIssue
(message)PromotionStatus.ItemLevelIssue.Severity
(enum)RedemptionChannel
(enum)StoreApplicability
(enum)
PromotionsService
Service permettant de gérer les promotions de produits.
GetPromotion |
---|
Récupère la promotion à partir de votre compte Merchant Center. Après l'insertion ou la mise à jour d'une promotion, plusieurs minutes peuvent s'écouler avant que la promotion mise à jour puisse être récupérée.
|
InsertPromotion |
---|
Insère une promotion pour votre compte Merchant Center. Si la promotion existe déjà, la promotion est mise à jour à la place.
|
ListPromotions |
---|
Liste les promotions dans votre compte Merchant Center. La réponse peut contenir moins d'éléments que spécifié par Une fois que vous avez inséré ou mis à jour une promotion, plusieurs minutes peuvent s'écouler avant que la promotion traitée mise à jour puisse être récupérée.
|
Attributs
Attributs.
Champs | |
---|---|
product_applicability |
Obligatoire. Applicabilité de la promotion à tous les produits ou uniquement à des produits spécifiques. |
offer_type |
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. |
generic_redemption_code |
Facultatif. Code promotionnel générique pour la promotion. À utiliser avec le champ |
long_title |
Obligatoire. Titre long de la promotion |
coupon_value_type |
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. |
promotion_destinations[] |
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 |
item_id_inclusion[] |
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 |
brand_inclusion[] |
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 |
item_group_id_inclusion[] |
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 [product_applicability] est défini sur specific_products. |
product_type_inclusion[] |
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 |
item_id_exclusion[] |
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 |
brand_exclusion[] |
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 |
item_group_id_exclusion[] |
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 |
product_type_exclusion[] |
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 |
minimum_purchase_amount |
Facultatif. Montant minimal d'achat associé à la promotion. |
minimum_purchase_quantity |
Facultatif. Quantité minimale à acheter pour la promotion. |
limit_quantity |
Facultatif. Quantité maximale par commande pour la promotion. |
limit_value |
Facultatif. Prix maximal du produit pour la promotion. |
percent_off |
Facultatif. Pourcentage de remise sans frais dans la promotion. |
money_off_amount |
Facultatif. Montant de la remise proposée dans le cadre de la promotion. |
get_this_quantity_discounted |
Facultatif. Nombre d'articles à prix réduit dans la promotion. L'attribut est défini lorsque |
free_gift_value |
Facultatif. Valeur du cadeau pour la promotion. |
free_gift_description |
Facultatif. Description du cadeau sans frais pour la promotion. |
free_gift_item_id |
Facultatif. Identifiant du cadeau sans frais pour la promotion. |
promotion_effective_time_period |
Obligatoire. Représentation par |
promotion_display_time_period |
Facultatif. Représentation |
store_applicability |
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 |
store_codes_inclusion[] |
Facultatif. Codes de magasin à inclure pour la promotion. Les attributs de filtre de magasins ne s'appliquent que lorsque l'attribut 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. |
store_codes_exclusion[] |
Facultatif. Codes de magasin à exclure de la promotion. Les attributs de filtre de magasins ne s'appliquent que lorsque l'attribut |
promotion_url |
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 |
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. minimum_purchase_quantity et get_this_quantity_discounted doivent être présents. money_off_amount 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. minimum_purchase_quantity et get_this_quantity_discounted 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. minimum_purchase_quantity et money_off_amount doivent être présents. |
BUY_M_GET_PERCENT_OFF |
Bénéficiez d'une remise pour M produits achetés. minimum_purchase_quantity 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". |
GetPromotionRequest
Message de requête pour la méthode GetPromotion
.
Champs | |
---|---|
name |
Obligatoire. Nom de la promotion à récupérer. Format : |
InsertPromotionRequest
Message de requête pour la méthode InsertPromotion
.
Champs | |
---|---|
parent |
Obligatoire. Compte dans lequel la promotion sera insérée. Format: accounts/{account} |
promotion |
Obligatoire. Promotion à insérer. |
data_source |
Obligatoire. Source de données du format de la promotion: |
ListPromotionsRequest
Message de requête pour la méthode ListPromotions
.
Champs | |
---|---|
parent |
Obligatoire. Compte pour lequel répertorier les promotions traitées. Format : |
page_size |
Uniquement en sortie. Nombre maximal de promotions à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. Si aucune valeur n'est spécifiée, le nombre maximal de promotions est renvoyé. |
page_token |
Uniquement en sortie. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListPromotionsResponse
Message de réponse pour la méthode ListPromotions
.
Champs | |
---|---|
promotions[] |
Promotions traitées à partir du compte spécifié. |
next_page_token |
Jeton pouvant être envoyé en tant que |
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 . |
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. |
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:
- Spécifications des données sur les promotions
- Spécifications des données sur les promotions en magasin
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.
Champs | |
---|---|
name |
Identifiant. Nom de la promotion. Format : |
promotion_id |
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. |
content_language |
Obligatoire. Code de langue ISO 639-1 à deux lettres pour la promotion. Les promotions ne sont disponibles que pour certaines langues. |
target_country |
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 |
redemption_channel[] |
Obligatoire. Canal d'utilisation de la promotion. Veuillez indiquer au moins un canal. |
data_source |
Uniquement en sortie. Source de données principale de la promotion. |
attributes |
Facultatif. Liste des attributs de la promotion. |
custom_attributes[] |
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, |
promotion_status |
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. |
version_number |
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' Si l'opération est empêchée, l'exception annulée est générée. |
PromotionStatus
État de la promotion.
Champs | |
---|---|
destination_statuses[] |
Uniquement en sortie. Destinations prévues de la promotion. |
item_level_issues[] |
Uniquement en sortie. Liste des problèmes associés à la promotion. |
creation_date |
Uniquement en sortie. Date de création de la promotion au format ISO 8601: date, heure et décalage (par exemple, |
last_update_date |
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, |
DestinationStatus
État de la destination spécifiée.
Champs | |
---|---|
reporting_context |
Uniquement en sortie. Nom de la destination de la promotion. |
status |
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.
Champs | |
---|---|
code |
Uniquement en sortie. Code d'erreur du problème |
severity |
Uniquement en sortie. Impact de ce problème sur la diffusion de la promotion |
resolution |
Uniquement en sortie. Indique si le problème peut être résolu par le marchand. |
attribute |
Uniquement en sortie. Nom de l'attribut, si le problème est causé par un seul attribut. |
reporting_context |
Uniquement en sortie. Destination à laquelle le problème s'applique. |
description |
Uniquement en sortie. Une brève description du problème en anglais. |
detail |
Uniquement en sortie. Une description détaillée du problème en anglais. |
documentation |
Uniquement en sortie. URL d'une page Web qui vous aide à résoudre ce problème. |
applicable_countries[] |
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. |
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. |
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. |