Migrer la gestion des promotions

Vous pouvez utiliser l'API Merchant Promotions pour créer et gérer des promotions sur Google. La ressource accounts.promotions vous permet de présenter des offres spéciales pour les produits que vous vendez sur Google. Pour en savoir plus, consultez la présentation de l'API Promotions des marchands.

Présentation des modifications apportées à Content API for Shopping pour Merchant API

Une différence importante est que Content API for Shopping crée automatiquement la source de données lors de la première insertion de promotion, ce qui n'est pas le cas avec Merchant API. Pour insérer une promotion à l'aide de Merchant API, vous devez d'abord créer une source de données de promotions.

Pour en savoir plus sur les champs de l'objet promotionDataSource dans la ressource accounts.dataSources, consultez PromotionDataSource.

Sources de données existantes

Pour les sources de données existantes, si vous ne connaissez pas votre accounts.dataSources.name, utilisez dataSources.list pour le récupérer.

Vous pouvez également identifier la source de données de chacune de vos promotions en utilisant la accounts.promotions.get méthode et en inspectant le dataSource champ dans la réponse de toutes les promotions existantes de votre compte.

Pour y faire référence directement lors de futurs appels d'API, nous vous recommandons vivement de stocker le accounts.dataSources.name dans votre base de données locale pour chaque promotion.

Requêtes

Pour effectuer des requêtes, utilisez l'URL suivante.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Migrer depuis Content API for Shopping

Le tableau suivant compare Content API for Shopping à l'API Promotions des marchands pour les requêtes liées aux promotions.

URL

Dans Content API for Shopping :

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

dans Merchant API devient :

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

Identifiants

Dans Content API for Shopping :

{MERCHANT_ID}/promotions/{PROMOTION_ID}

dans Merchant API devient :

{NAME}

Méthodes

Merchant API est compatible avec les méthodes suivantes pour les promotions :

  • Insérer des promotions
  • Obtenir des promotions
  • Lister les promotions

Voici une comparaison de la disponibilité des méthodes de promotion dans Content API for Shopping et Merchant API :

Fonctionnalité Content API for Shopping API Merchant
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
Identifiants {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Méthodes
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list

Modifications apportées aux champs

Le tableau indique les modifications apportées aux promotions des marchands dans l'API Merchant Promotions.

Pour obtenir un exemple à titre de référence, consultez accounts.promotions.

Content API for Shopping API Merchant Description
(non compatible) custom_attributes Liste d'attributs personnalisés (fournis par l'utilisateur). Vous pouvez
également l'utiliser pour envoyer n'importe quel attribut des
spécifications du flux sous sa forme générique.
Par exemple : 
{
  "name": "size type", "value": "regular"
}
Utile pour envoyer des attributs qui ne sont pas
explicitement exposés par l'API.
Non compatible data_source La création d'une promotion nécessite une source de données existante.
Non compatible attributes Les attributs spécifiques aux promotions, par exemple,
long_tile, promotion_effective_timeperiod,
et autres, font partie du message d'attribut.
item_id item_id_inclusion La liste des ID d'articles auxquels une promotion s'applique
est renommée.
store_id store_id_inclusion La liste des ID de magasin auxquels une promotion s'applique
est renommée.
product_type product_type_inclusion La liste des types de produits auxquels une promotion s'applique
est renommée.
item_group_id item_group_id_inclusion La liste des ID de groupe d'articles auxquels une promotion s'applique
est renommée.
brand brand_inclusion La liste des marques auxquelles une promotion s'applique
est renommée.
store_code store_codes_inclusion La liste des codes de magasin auxquels une promotion s'applique
est renommée. 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
La définition de Price a changé.

Dans Content API for Shopping, Price
était un nombre décimal sous la forme d'une chaîne.

Le montant Price est désormais enregistré en micro-unités,
où 1 million de micro-unités équivaut à l'unité standard de votre
devise.

Le nom du champ amount est passé de value à
amountMicros.

Le nom du champ currency est passé à
currencyCode. Le format reste comme
ISO 4217. (Wikipédia)

order_limit (non compatible) L'attribut order_limit n'est pas compatible.
shippingServiceNames[] (non compatible) shippingServiceNames[] n'est pas compatible.
money_budget (non compatible) money_budget n'est pas compatible.
promotion_destination_ids promotion_destinations promotionDestinationIds est renommé.
État de la promotion 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
L' état de la promotion a changé.
Des informations plus précises sont disponibles dans les problèmes. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}
Précédent
Migrate order tracking signals
Suivant
Migrate conversion sources management