Migrer les rapports depuis Content API for Shopping

Voici comment intégrer les rapports sur les marchands API avec votre API Content pour Shopping.

Demandes

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

POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search

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

Content API API Merchant Center
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Identifiants {merchantId} {parent}

Méthodes

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

Vues

Dans l'API Merchant Center, le nom des tables passe de CammelCase à snake_case.

MerchantPerformanceView est désormais product_performance_view.

Voici les correspondances entre les noms de tables dans Content API for Shopping et les API pour les marchands:

Content API API Merchant Center
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 Center, spécifier un préfixe de champ, par exemple segments.offer_id n'est plus obligatoire. Utilisez plutôt le nom du champ, offer_id.

Voici un exemple de comparaison de requêtes dans Content API for Shopping et dans les API pour les marchands:

Content API API Merchant Center
   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 Center
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

Le nom de la table peut servir de préfixe de champ. Par exemple, offer_id et Les product_performance_view.offer_id sont acceptées dans la requête de l'API Merchant Center.

Performances

Voici les modifications apportées à l'affichage des performances dans l'API Merchant Reports:

Content API API Merchant Center Description
segments.program : chaîne marketing_method : chaîne program segment 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)
}
Fusion des champs "Nombre de micros" et "Devise" en un seul champ de type Price
metrics.orders,
metrics.orderedItems,
Non compatible Les métriques Acheter sur Google ne sont pas compatibles avec l'API Merchant Reports

Valeurs de la nouvelle méthode marketing

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

Content API API Merchant Center
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Non compatible

Produit

Voici les modifications apportées à la vue des produits dans l'API Merchant Reports:

Content API API Merchant Center 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)
}
Fusion des champs "Nombre de micros" et "Devise" 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, 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 compatible feedLabel : chaîne Introduction du champ feedLabel

Tendances des prix

Voici les modifications apportées à la vue "Tendances des prix" dans l'API Merchant Reports:

Content API API Merchant Center 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)
}
Fusion des champs "Nombre de micros" et "Devise" en un seul champ de type Price
priceInsights.suggestedPriceMicros: entier
priceInsights.suggestedPriceCurrencyCode: chaîne
suggestedPrice: {
object (Price)
}
Fusion des champs "Nombre de micros" et "Devise" en un seul champ de type Price
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: entier
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: chaîne
Non compatible Les champs liés à la variation de la marge brute ne sont pas acceptés dans l'API Merchant Reports.

Compétitivité tarifaire

Voici les modifications apportées à l'affichage "Compétitivité tarifaire" dans les rapports sur les marchands API:

Content API API Merchant Center 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)
}
Fusion des champs "Nombre de micros" et "Devise" en un seul champ de type Price
priceCompetitiveness.countryCode : chaîne reportCountryCode : chaîne Le champ countryCode a été renommé reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: entier
priceCompetitiveness.benchmarkPriceCurrencyCode: chaîne
benchmarkPrice: {
object (Price)
}
Fusion des champs "Nombre de micros" et "Devise" en un seul champ de type Price

Meilleures ventes

Voici les modifications apportées aux vues "Meilleures ventes" dans l'API Merchant Reports:

Content API API Merchant Center Description
bestSellers.countryCode : chaîne reportCountryCode : chaîne Le champ countryCode a été renommé reportCountryCode
bestSellers.categoryId: entier reportCategoryId: entier Le champ categoryId a été renommé reportCategoryId

Visibilité par rapport aux concurrents

Voici les modifications apportées aux vues "Visibilité par rapport aux concurrents" dans l'API Merchant Reports:

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