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 Présentation de l'API Merchant Promotions.

Présentation des changements entre Content API for Shopping et l'API Merchant

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 à l'aide de la méthode accounts.promotions.get et en inspectant le champ dataSource dans la réponse de toutes les promotions existantes de votre compte.

Pour y faire référence directement dans les futurs appels d'API, nous vous recommandons vivement de stocker l'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 l'API Merchant devient :

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

Identifiants

Dans Content API for Shopping :

{MERCHANT_ID}/promotions/{PROMOTION_ID}

dans l'API Merchant devient :

{NAME}

Méthodes

Merchant API accepte les méthodes suivantes pour les promotions :

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

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

Modifications de champs

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

Pour voir un exemple, consultez accounts.promotions.

{
  "name": "size type", "value": "regular"
}

price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }

{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}

promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}