Migrer les rapports depuis Content API for Shopping

Vous pouvez utiliser l'API Merchant Reports pour en savoir plus sur vos produits, leurs performances et leur environnement concurrentiel sur Google grâce à la vue de données qu'elle propose.

Vous pouvez utiliser l'API Merchant Reports pour effectuer les opérations suivantes :

Voici comment intégrer l'API Merchant Reports à votre implémentation existante de l'API Content for Shopping.

Requêtes

Utilisez le format d'URL de requête suivant pour l'API Merchant Reports :

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

Voici un exemple de comparaison entre Content API for Shopping et l'API Merchant Reports pour les requêtes search :

Content API API Merchant
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search
Identifiants {MERCHANT_ID} {PARENT}

Méthodes

Vous pouvez interroger l'API Merchant Reports en appelant la méthode ReportService.Search.

Vues

Dans l'API Merchant, les noms de tables sont passés de CamelCase à snake_case.

MerchantPerformanceView est désormais product_performance_view.

Voici une correspondance entre les noms de tables dans Content API for Shopping et l'API Merchant :

Content API API Merchant
MerchantPerformanceView product_performance_view
ProductView product_view
PriceCompetitivenesProductView price_competitiveness_product_view
PriceInsightsProductView price_insights_product_view
BestSellersBrandView best_sellers_brand_view
BestSellersProductClusterView best_sellers_product_cluster_view
CompetitiveVisibilityCompetitorView competitive_visibility_competitor_view
CompetitiveVisibilityTopMerchantView competitive_visibility_top_merchant_view
CompetitiveVisibilityBenchmarkView competitive_visibility_benchmark_view

Dans l'API Merchant, il n'est plus nécessaire de spécifier un préfixe de champ, par exemple segments.offer_id. Utilisez plutôt le nom du champ, offer_id.

Voici un exemple de comparaison des requêtes dans Content API for Shopping et dans l'API Merchant :

Content API API Merchant 
   SELECT
     segments.offer_id,
     metrics.clicks
   FROM MerchantPerformanceView
   WHERE segments.date DURING LAST_7_DAYS
   
   SELECT
     offer_id,
     clicks
   FROM product_performance_view
   WHERE date DURING LAST_7_DAYS

Voici un exemple de réponse :

Content API API Merchant 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
 
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

Le nom de la table peut être utilisé comme préfixe de champ. Par exemple, offer_id et product_performance_view.offer_id sont acceptés dans la requête Merchant API.

Performances

Voici ce qui a changé pour la vue des performances dans l'API Merchant Reports :

Content API API Merchant Description
segments.program : chaîne marketing_method : chaîne Le segment program est remplacé par un nouveau champ marketing_method. Pour en savoir plus, consultez Nouvelles valeurs marketing method.
metrics.ctr : double clickThroughRate : double La métrique ctr a été renommée clickThroughRate.
metrics.conversionValueMicros : entier
segments.currencyCode : chaîne 		conversionValue: {
object (Price)
} 		Les champs "Montant en micro-unités" et "Devise" sont fusionnés en un seul champ de type Price.
metrics.orders,
metrics.orderedItems,
… 		Non autorisé Les métriques Acheter sur Google ne sont pas compatibles avec l'API Merchant Reports.

Nouvelles valeurs de méthode de marketing

Voici le mappage entre les valeurs segments.program et marketing_method :

Content API API Merchant
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Non autorisé

Produit

Voici ce qui a changé pour la vue Produit dans l'API Merchant Reports :

Content API API Merchant Description
productView.id : chaîne id : chaîne Le format du champ passe de channel:language:targetCountry:offerId à
channel~language~feedLabel~offerId.
productView.priceMicros : entier
productView.currencyCode : chaîne 		price: {
object (Price)
} 		Les champs "Montant en micro-unités" et "Devise" sont fusionnés en un seul champ de type Price.
productView.aggregated_destination_status : chaîne aggregated_reporting_context_status : chaîne Le champ aggregated_destination_status a été renommé aggregated_reporting_context_status, mais les valeurs n'ont pas changé.
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		La définition de ItemIssue a été modifiée
Non autorisé feedLabel : chaîne Introduction du champ feedLabel

Tendances des prix

Voici ce qui a changé dans la vue "Tendances des prix" de l'API Merchant Reports :

Content API API Merchant Description
productView.id : chaîne id : chaîne Le format du champ passe de channel:language:targetCountry:offerId à channel~language~feedLabel~offerId
productView.priceMicros : entier
productView.currencyCode : chaîne 		price: {
object (Price)
} 		Les champs "Montant en micro-unités" et "Devise" sont fusionnés en un seul champ de type Price.
priceInsights.suggestedPriceMicros : entier
priceInsights.suggestedPriceCurrencyCode : chaîne 		suggestedPrice: {
object (Price)
} 		Les champs "Montant en micro-unités" et "Devise" sont fusionnés en un seul champ de type Price.
priceInsights.predictedGrossProfitChangeFraction : double
priceInsights.predictedMonthlyGrossProfitChangeMicros : entier
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode : chaîne 		Non autorisé Les champs liés à la variation de la marge brute ne sont pas acceptés dans l'API Merchant Reports.

Compétitivité tarifaire

Voici ce qui a changé pour la vue de la compétitivité tarifaire dans l'API Merchant Reports :

Content API API Merchant Description
productView.id : chaîne id : chaîne Le format du champ passe de channel:language:targetCountry:offerId à channel~language~feedLabel~offerId.
productView.priceMicros : entier
productView.currencyCode : chaîne 		price: {
object (Price)
} 		Les champs "Montant en micro-unités" et "Devise" sont fusionnés en un seul champ de type Price.
priceCompetitiveness.countryCode : chaîne reportCountryCode : chaîne Le champ countryCode est renommé reportCountryCode.
priceCompetitiveness.benchmarkPriceMicros : entier
priceCompetitiveness.benchmarkPriceCurrencyCode : chaîne 		benchmarkPrice: {
object (Price)
} 		Les champs "Montant en micro-unités" et "Devise" sont fusionnés en un seul champ de type Price.

Meilleures ventes

Voici ce qui a changé pour les vues "Meilleures ventes" dans l'API Merchant Reports :

Content API API Merchant Description
bestSellers.countryCode : chaîne reportCountryCode : chaîne Le champ countryCode est renommé reportCountryCode.
bestSellers.categoryId : int reportCategoryId : int Le champ categoryId est renommé reportCategoryId.

Visibilité par rapport aux concurrents

Voici les modifications apportées aux vues de la visibilité par rapport aux concurrents dans l'API Merchant Reports :

Content API API Merchant Description
competitiveVisibility.countryCode : chaîne reportCountryCode : chaîne Le champ countryCode est renommé reportCountryCode.
competitiveVisibility.categoryId : entier reportCategoryId : entier Le champ categoryId est renommé reportCategoryId.

Précédent
Migrate products management
Suivant
Migrate data sources management