Migrer la gestion des promotions

Vous pouvez utiliser l'API Promotions des marchands 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 page Présentation de l'API Promotions des marchands.

Requêtes

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

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

Migrer depuis Content API for Shopping

La section suivante compare l'API 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/{merchantId}/promotions

dans l'API Merchant Center devient:

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

Identifiants

Dans Content API for Shopping:

{merchantId}/promotions/{promotionId}

dans l'API Merchant Center devient:

{name}

Méthodes

L'API Merchant Center accepte les méthodes suivantes pour les promotions:

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

Voici un comparatif des méthodes de promotion disponibles dans Content API for Shopping et l'API Merchant Center:

Méthode Content API for Shopping API Merchant Center
insérer Oui Oui
get Oui Oui
liste Oui Oui
customBatch Non Non
supprimer Non (À déterminer)

Nom de la ressource

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

Pour consulter un exemple à titre de référence, consultez la section Local Inventory (Inventaire en magasin).

Content API for Shopping API Merchant Center Description
(non compatible) custom_attributes Liste d'attributs personnalisés (fournis par le marchand). Vous pouvez
l'utiliser également pour envoyer n'importe quel attribut de la spécification
du flux sous sa forme générique.
Par exemple : 
{
  "name": "size type", "value": "regular"
}
Ceci est utile pour envoyer des attributs qui ne sont pas explicitement
diffusés par l'API.
Non autorisé data_source Pour créer une promotion, vous devez disposer d'une source de données.
Non autorisé attributs [attributs] Les attributs spécifiques à la promotion, par exemple
long_tile, promotion_effective_timeperiod,
et d'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 identifiants des magasins auxquels une promotion s'applique
est renommée.
prduct_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, l'attribut price
était un nombre décimal sous forme de chaîne.

Le montant du champ 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 (montant) est passé de "value" à "
" amountMicros.

Le nom du champ currency a été remplacé par
currencyCode. Le format reste
ISO 4217. (Wikipédia)

order_limit (non compatible) L'attribut order_limit n'est pas compatible.
shippingServiceNames[] (non compatible) shippingServiceNames[] n'est pas accepté.
money_budget (non compatible) money_budget n'est pas accepté.
promotion_destination_ids promotion_destinations promotionDestinationIds a été 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 été modifié.
Vous trouverez des informations plus détaillées 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,
    ]
    }
  ]
}