Package google.shopping.merchant.reports.v1beta

Index

• ReportService (interface)
• BestSellersBrandView (message)
• BestSellersProductClusterView (message)
• BestSellersProductClusterView.InventoryStatus (enum)
• CompetitiveVisibilityBenchmarkView (message)
• CompetitiveVisibilityCompetitorView (message)
• CompetitiveVisibilityTopMerchantView (message)
• MarketingMethod (message)
• MarketingMethod.MarketingMethodEnum (enum)
• NonProductPerformanceView (message)
• PriceCompetitivenessProductView (message)
• PriceInsightsProductView (message)
• PriceInsightsProductView.Effectiveness (enum)
• ProductPerformanceView (message)
• ProductView (message)
• ProductView.AggregatedReportingContextStatus (enum)
• ProductView.ClickPotential (enum)
• ProductView.ItemIssue (message)
• ProductView.ItemIssue.ItemIssueResolution (enum)
• ProductView.ItemIssue.ItemIssueSeverity (message)
• ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity (enum)
• ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext (message)
• ProductView.ItemIssue.ItemIssueType (message)
• RelativeDemand (message)
• RelativeDemand.RelativeDemandEnum (enum)
• RelativeDemandChangeType (message)
• RelativeDemandChangeType.RelativeDemandChangeTypeEnum (enum)
• ReportGranularity (message)
• ReportGranularity.ReportGranularityEnum (enum)
• ReportRow (message)
• SearchRequest (message)
• SearchResponse (message)
• TrafficSource (message)
• TrafficSource.TrafficSourceEnum (enum)

ReportService

Service permettant de récupérer des rapports et des insights sur vos produits, leurs performances et leur environnement concurrentiel sur Google.

Rechercher

rpc Search(SearchRequest) returns (SearchResponse) Récupère un rapport défini par une requête de recherche. La réponse peut contenir moins de lignes que spécifié par page_size. Utilisez next_page_token pour déterminer si d'autres lignes doivent être demandées. Champs d'application des autorisations Requiert le niveau d'accès OAuth suivant : https://www.googleapis.com/auth/content Pour en savoir plus, consultez la présentation d'OAuth 2.0.

BestSellersBrandView

Champs disponibles pour les requêtes dans la table best_sellers_brand_view.

Un rapport Meilleures ventes avec les marques populaires.

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
report_date	Date Date du rapport. La valeur de ce champ ne peut être que l'une des suivantes: Le premier jour de la semaine (lundi) pour les rapports hebdomadaires, Premier jour du mois pour les rapports mensuels. Obligatoire dans la clause SELECT. Si aucune condition WHERE sur report_date n'est spécifiée dans la requête, le dernier rapport hebdomadaire ou mensuel disponible est renvoyé.
report_granularity	ReportGranularityEnum Précision du rapport. Le classement peut être effectué sur une semaine ou sur un mois. Obligatoire dans la clause SELECT. La condition sur report_granularity est requise dans la clause WHERE.
report_country_code	string Pays dans lequel le classement est calculé. Représenté au format ISO 3166. Obligatoire dans la clause SELECT. La condition sur report_country_code est requise dans la clause WHERE.
report_category_id	int64 ID de la catégorie de produits Google pour laquelle calculer le classement, représenté dans la classification des produits Google. Obligatoire dans la clause SELECT. Si aucune condition WHERE sur report_category_id n'est spécifiée dans la requête, les classements de toutes les catégories de niveau supérieur sont renvoyés.
brand	string Nom de la marque.
rank	int64 Popularité de la marque dans les annonces et sur les plates-formes naturelles, dans la catégorie et le pays sélectionnés, en fonction du nombre estimé d'unités vendues.
previous_rank	int64 Popularité au cours de la semaine ou du mois précédents.
relative_demand	RelativeDemandEnum Estimation de la demande pour la marque la plus populaire dans la même catégorie et le même pays.
previous_relative_demand	RelativeDemandEnum Estimation de la demande pour la marque la plus populaire dans la même catégorie et le même pays la semaine ou le mois précédents.
relative_demand_change	RelativeDemandChangeTypeEnum Évolution de la demande estimée. Est-ce qu'elle a augmenté, coulé ou est restée à plat ?

BestSellersProductClusterView

Champs disponibles pour les requêtes dans la table best_sellers_product_cluster_view.

Rapport Meilleures ventes avec les clusters de produits les plus performants. Un cluster de produits est un regroupement de différentes offres et variantes qui représentent le même produit (par exemple, le Google Pixel 7).

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
report_date	Date Date du rapport. La valeur de ce champ ne peut être que l'une des suivantes: Le premier jour de la semaine (lundi) pour les rapports hebdomadaires, Premier jour du mois pour les rapports mensuels. Obligatoire dans la clause SELECT. Si aucune condition WHERE sur report_date n'est spécifiée dans la requête, le dernier rapport hebdomadaire ou mensuel disponible est renvoyé.
variant_gtins[]	string Codes GTIN des exemples de variantes du cluster de produits.
report_granularity	ReportGranularityEnum Précision du rapport. Le classement peut être effectué sur une semaine ou sur un mois. Obligatoire dans la clause SELECT. La condition sur report_granularity est requise dans la clause WHERE.
report_country_code	string Pays dans lequel le classement est calculé. Représenté au format ISO 3166. Obligatoire dans la clause SELECT. La condition sur report_country_code est requise dans la clause WHERE.
report_category_id	int64 ID de la catégorie de produits Google pour laquelle calculer le classement, représenté dans la classification des produits Google. Obligatoire dans la clause SELECT. Si aucune condition WHERE sur report_category_id n'est spécifiée dans la requête, les classements de toutes les catégories de niveau supérieur sont renvoyés.
title	string Titre du cluster de produits.
brand	string Marque du groupe de produits.
category_l1	string Catégorie de produits (1er niveau) du cluster de produits, représentée dans la classification des produits Google.
category_l2	string Catégorie de produits (2e niveau) du cluster de produits, représentée dans la classification des produits Google.
category_l3	string Catégorie de produits (3e niveau) du cluster de produits, représentée dans la classification des produits Google.
category_l4	string Catégorie de produits (4e niveau) du cluster de produits, représentée dans la classification des produits Google.
category_l5	string Catégorie de produits (5e niveau) du cluster de produits, représentée dans la classification des produits Google.
inventory_status	InventoryStatus Indique si le cluster de produits est IN_STOCK dans votre source de données produit pour au moins un des pays, OUT_OF_STOCK dans votre source de données produit pour tous les pays ou NOT_IN_INVENTORY pas du tout. Ce champ ne tient pas compte du filtre par pays du rapport "Meilleures ventes".
brand_inventory_status	InventoryStatus Si votre source de données produit contient actuellement au moins un produit de la marque IN_STOCK dans au moins un des pays, tous les produits sont associés à l'état OUT_OF_STOCK dans votre source de données produit pour tous les pays, ou à l'état NOT_IN_INVENTORY. Ce champ ne tient pas compte du filtre par pays du rapport "Meilleures ventes".
rank	int64 Popularité du groupe de produits dans les annonces et sur les plates-formes naturelles, dans la catégorie et le pays sélectionnés, en fonction du nombre estimé d'unités vendues.
previous_rank	int64 Popularité au cours de la semaine ou du mois précédents.
relative_demand	RelativeDemandEnum Demande estimée par rapport au cluster de produits le plus populaire dans la même catégorie et le même pays.
previous_relative_demand	RelativeDemandEnum Demande estimée par rapport au cluster de produits le plus populaire dans la même catégorie et le même pays la semaine ou le mois précédents.
relative_demand_change	RelativeDemandChangeTypeEnum Évolution de la demande estimée. Est-ce qu'elle a augmenté, coulé ou est restée à plat ?

InventoryStatus

État du cluster de produits ou de la marque dans votre inventaire.

Enums
INVENTORY_STATUS_UNSPECIFIED	Non spécifié.
IN_STOCK	Un produit de ce groupe de produits ou de cette marque est en stock.
OUT_OF_STOCK	Un produit de ce groupe de produits ou de cette marque est dans l'inventaire, mais il n'est pas disponible pour le moment.
NOT_IN_INVENTORY	Vous n'avez pas de produit pour ce groupe de produits ou cette marque dans l'inventaire.

CompetitiveVisibilityBenchmarkView

Champs disponibles pour les requêtes dans la table competitive_visibility_benchmark_view.

Rapport Visibilité sur vos concurrents avec le benchmark de la catégorie.

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
date	Date Date de cette ligne. Obligatoire dans la clause SELECT. Une condition pour date est requise dans la clause WHERE.
report_country_code	string Pays dans lequel les impressions sont apparues. Obligatoire dans la clause SELECT. Une condition pour report_country_code est requise dans la clause WHERE.
report_category_id	int64 ID de la catégorie de produits Google pour laquelle le rapport doit être calculé, représenté dans la classification des produits Google. Obligatoire dans la clause SELECT. Une condition pour report_category_id est requise dans la clause WHERE.
traffic_source	TrafficSourceEnum Source de trafic des impressions Obligatoire dans la clause SELECT.
your_domain_visibility_trend	double Variation de la visibilité basée sur les impressions de votre domaine par rapport au début de la période sélectionnée (ou au premier jour si le nombre d'impressions est différent de zéro). Ne peut pas être filtré dans la clause 'WHERE'.
category_benchmark_visibility_trend	double Variation de la visibilité basée sur les impressions par rapport au début de la période sélectionnée (ou au premier jour avec des impressions non nulles) pour un ensemble combiné de marchands présentant la meilleure visibilité à proximité du marché. Ne peut pas être filtré dans la clause 'WHERE'.

CompetitiveVisibilityCompetitorView

Champs disponibles pour les requêtes dans la table competitive_visibility_competitor_view.

Visibilité sur vos concurrents avec des entreprises ayant une visibilité similaire.

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
date	Date Date de cette ligne. Une condition pour date est requise dans la clause WHERE.
domain	string Domaine de votre concurrent ou de votre domaine, si "is_your_domain" est vrai. Obligatoire dans la clause SELECT. Ne peut pas être filtré dans la clause 'WHERE'.
is_your_domain	bool "True" si cette ligne contient des données pour votre domaine. Ne peut pas être filtré dans la clause 'WHERE'.
report_country_code	string Pays dans lequel les impressions sont apparues. Obligatoire dans la clause SELECT. Une condition pour report_country_code est requise dans la clause WHERE.
report_category_id	int64 ID de la catégorie de produits Google pour laquelle le rapport doit être calculé, représenté dans la classification des produits Google. Obligatoire dans la clause SELECT. Une condition pour report_category_id est requise dans la clause WHERE.
traffic_source	TrafficSourceEnum Source de trafic des impressions Obligatoire dans la clause SELECT.
rank	int64 Position du domaine dans le classement des établissements similaires pour les clés sélectionnées (date, report_category_id, report_country_code, traffic_source) en fonction du nombre d'impressions. 1 correspond au niveau le plus élevé. Ne peut pas être filtré dans la clause 'WHERE'.
ads_organic_ratio	double Le ratio annonces / résultats naturels indique la fréquence à laquelle le domaine enregistre des impressions provenant d'annonces Shopping par rapport au trafic généré par les résultats naturels. Le nombre est arrondi et regroupé. Ne peut pas être filtré dans la clause 'WHERE'.
page_overlap_rate	double Le taux de superposition de la page indique la fréquence à laquelle les offres des marchands concurrents s'affichent avec les vôtres sur la même page. Ne peut pas être filtré dans la clause 'WHERE'.
higher_position_rate	double Le taux de position plus élevée indique la fréquence à laquelle l'offre d'un concurrent a été placée à une meilleure position sur la page que la vôtre. Ne peut pas être filtré dans la clause 'WHERE'.
relative_visibility	double La visibilité relative indique la fréquence à laquelle les offres de vos concurrents sont diffusées par rapport aux vôtres. En d'autres termes, il s'agit du nombre d'impressions diffusées par un marchand concurrent, divisé par le nombre d'impressions affichées au cours d'une période donnée, pour une catégorie de produits et un pays sélectionnés. Ne peut pas être filtré dans la clause 'WHERE'.

CompetitiveVisibilityTopMerchantView

Champs disponibles pour les requêtes dans la table competitive_visibility_top_merchant_view.

Ce rapport Visibilité sur vos concurrents indique l'entreprise bénéficiant de la meilleure visibilité.

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
date	Date Date de cette ligne. Ne peut pas être sélectionné dans la clause SELECT. Une condition pour date est requise dans la clause WHERE.
domain	string Domaine de votre concurrent ou de votre domaine, si "is_your_domain" est vrai. Obligatoire dans la clause SELECT. Ne peut pas être filtré dans la clause 'WHERE'.
is_your_domain	bool "True" si cette ligne contient des données pour votre domaine. Ne peut pas être filtré dans la clause 'WHERE'.
report_country_code	string Pays dans lequel les impressions sont apparues. Obligatoire dans la clause SELECT. Une condition pour report_country_code est requise dans la clause WHERE.
report_category_id	int64 ID de la catégorie de produits Google pour laquelle le rapport doit être calculé, représenté dans la classification des produits Google. Obligatoire dans la clause SELECT. Une condition pour report_category_id est requise dans la clause WHERE.
traffic_source	TrafficSourceEnum Source de trafic des impressions Obligatoire dans la clause SELECT.
rank	int64 Position du domaine dans le classement des principaux marchands pour les clés sélectionnées (date, report_category_id, report_country_code, traffic_source) en fonction du nombre d'impressions. 1 correspond au niveau le plus élevé. Ne peut pas être filtré dans la clause 'WHERE'.
ads_organic_ratio	double Le ratio annonces / résultats naturels indique la fréquence à laquelle le domaine enregistre des impressions provenant d'annonces Shopping par rapport au trafic généré par les résultats naturels. Le nombre est arrondi et regroupé. Ne peut pas être filtré dans la clause 'WHERE'.
page_overlap_rate	double Le taux de superposition de la page indique la fréquence à laquelle les offres des marchands concurrents s'affichent avec les vôtres sur la même page. Ne peut pas être filtré dans la clause 'WHERE'.
higher_position_rate	double Le taux de position plus élevée indique la fréquence à laquelle l'offre d'un concurrent a été placée à une meilleure position sur la page que la vôtre. Ne peut pas être filtré dans la clause 'WHERE'.

MarketingMethod

Ce type ne comporte aucun champ.

Méthode marketing utilisée pour promouvoir vos produits sur Google (résultats naturels ou annonces)

MarketingMethodEnum

Valeurs de méthode marketing.

Enums
MARKETING_METHOD_ENUM_UNSPECIFIED	Non spécifié.
ORGANIC	Marketing naturel.
ADS	Marketing basé sur les annonces

NonProductPerformanceView

Champs disponibles pour les requêtes dans la table non_product_performance_view.

Données sur les performances des images et des liens vers vos boutiques en ligne redirigeant vers des pages qui ne concernent pas vos produits. Cela inclut les métriques de performances (par exemple, clicks) et les dimensions selon lesquelles elles sont segmentées (par exemple, date).

Pour sélectionner des champs de segment dans les requêtes, vous devez également sélectionner au moins un champ de métrique.

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
date	Date Date (dans le fuseau horaire du marchand) à laquelle les métriques s'appliquent. Segmenter. La condition sur date est requise dans la clause WHERE.
week	Date Premier jour de la semaine (lundi) de la date correspondant aux métriques dans le fuseau horaire du marchand. Segmenter.
clicks	int64 Nombre de clics sur des images et des liens vers des boutiques en ligne redirigeant vers des pages qui ne concernent pas vos produits. Métrique.
impressions	int64 Nombre de fois où des images et des liens de boutiques en ligne redirigeant vers des pages qui ne concernent pas vos produits se sont affichés. Métrique.
click_through_rate	double Taux de clics : nombre de clics (clicks) divisé par le nombre d'impressions (impressions) provenant des images et des liens de boutiques en ligne redirigeant vers des pages qui ne sont pas des produits. Métrique.

PriceCompetitivenessProductView

Champs disponibles pour les requêtes dans la table price_competitiveness_product_view.

Le rapport Compétitivité tarifaire :

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
price	Price Prix actuel du produit.
benchmark_price	Price Dernier benchmark de prix disponible pour le catalogue du produit dans le pays de référence.
report_country_code	string Pays du benchmark de prix. Représenté au format ISO 3166. Obligatoire dans la clause SELECT.
id	string Identifiant REST du produit, au format channel~languageCode~feedLabel~offerId. Permet de joindre des données à la table product_view. Obligatoire dans la clause SELECT.
offer_id	string ID du produit fourni par le marchand.
title	string Titre du produit.
brand	string Marque du produit.
category_l1	string Catégorie du produit (1er niveau) dans la classification des produits Google.
category_l2	string Catégorie du produit (2e niveau) dans la classification des produits Google.
category_l3	string Catégorie du produit (3e niveau) dans la classification des produits Google.
category_l4	string Catégorie du produit (4e niveau) dans la classification des produits Google.
category_l5	string Catégorie du produit (5e niveau) dans la classification des produits Google.
product_type_l1	string Type de produit (1er niveau) dans la classification des produits propre au marchand.
product_type_l2	string Type de produit (2e niveau) dans la classification des produits propre au marchand.
product_type_l3	string Type de produit (3e niveau) dans la classification des produits propre au marchand.
product_type_l4	string Type de produit (4e niveau) dans la classification des produits propre au marchand.
product_type_l5	string Type de produit (5e niveau) dans la classification des produits propre au marchand.

PriceInsightsProductView

Champs disponibles pour les requêtes dans la table price_insights_product_view.

Le rapport Tendances des prix.

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
price	Price Prix actuel du produit.
suggested_price	Price Dernier prix suggéré pour le produit.
effectiveness	Effectiveness Estimation de l'efficacité de l'application de la suggestion de prix, segmentée.
id	string Identifiant REST du produit, au format channel~languageCode~feedLabel~offerId. Permet de joindre des données à la table product_view. Obligatoire dans la clause SELECT.
offer_id	string ID du produit fourni par le marchand.
title	string Titre du produit.
brand	string Marque du produit.
category_l1	string Catégorie du produit (1er niveau) dans la classification des produits Google.
category_l2	string Catégorie du produit (2e niveau) dans la classification des produits Google.
category_l3	string Catégorie du produit (3e niveau) dans la classification des produits Google.
category_l4	string Catégorie du produit (4e niveau) dans la classification des produits Google.
category_l5	string Catégorie du produit (5e niveau) dans la classification des produits Google.
product_type_l1	string Type de produit (1er niveau) dans la classification des produits propre au marchand.
product_type_l2	string Type de produit (2e niveau) dans la classification des produits propre au marchand.
product_type_l3	string Type de produit (3e niveau) dans la classification des produits propre au marchand.
product_type_l4	string Type de produit (4e niveau) dans la classification des produits propre au marchand.
product_type_l5	string Type de produit (5e niveau) dans la classification des produits propre au marchand.
predicted_impressions_change_fraction	double Estimation de la variation estimée des impressions, sous forme de fraction après l'introduction du prix suggéré, par rapport au prix actif actuel. Par exemple, 0,05 correspond à une augmentation prévue du nombre d'impressions de 5 %.
predicted_clicks_change_fraction	double Estimation de la variation du nombre de clics, exprimée en fraction après l'introduction du prix suggéré, par rapport au prix actif actuel. Par exemple, 0,05 correspond à une augmentation prévue du nombre de clics de 5 %.
predicted_conversions_change_fraction	double Estimation de la variation estimée des conversions, exprimée sous forme de fraction après l'introduction du prix suggéré, par rapport au prix actif actuel. Par exemple, 0,05 correspond à une augmentation prévue du nombre de conversions de 5 %.

Efficacité

Bucket prévu d'efficacité.

L'efficacité indique les produits qui bénéficieraient le plus d'un changement de prix. Cette note tient compte de l'amélioration des performances prévue en ajustant le prix soldé, ainsi que la différence entre votre prix actuel et le prix suggéré. Les suggestions de prix dont l'efficacité est HIGH sont susceptibles de générer la plus forte amélioration des performances.

Enums
EFFECTIVENESS_UNSPECIFIED	Efficacité inconnue.
LOW	L'efficacité est faible.
MEDIUM	Efficacité moyenne.
HIGH	L'efficacité est élevée.

ProductPerformanceView

Champs disponibles pour les requêtes dans la table product_performance_view.

Données sur les performances des produits dans votre compte, y compris les métriques de performances (par exemple, clicks) et les dimensions selon lesquelles ces métriques sont segmentées (par exemple, offer_id). Les valeurs des dimensions de produit, telles que offer_id, reflètent l'état du produit au moment de l'impression.

Pour sélectionner des champs de segment dans les requêtes, vous devez également sélectionner au moins un champ de métrique.

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
date	Date Date (dans le fuseau horaire du marchand) à laquelle les métriques s'appliquent. Segmenter. La condition sur date est requise dans la clause WHERE.
week	Date Premier jour de la semaine (lundi) de la date correspondant aux métriques dans le fuseau horaire du marchand. Segmenter.
conversion_value	Price Valeur des conversions attribuées au produit, enregistrée le jour de la conversion. Métrique. Disponible uniquement pour la source de trafic FREE.
marketing_method	MarketingMethodEnum Méthode marketing à laquelle les métriques s'appliquent. Segmenter.
customer_country_code	string Code du pays où se trouve le client au moment de l'événement. Représenté au format ISO 3166. Segmenter. Si le pays du client ne peut pas être déterminé, un code spécial "ZZ" est renvoyé.
offer_id	string ID du produit fourni par le marchand. Segmenter.
title	string Titre du produit. Segmenter.
brand	string Marque du produit. Segmenter.
category_l1	string Catégorie de produits (1er niveau) dans la classification des produits Google. Segmenter.
category_l2	string Catégorie de produits (2e niveau) dans la classification des produits Google Segmenter.
category_l3	string Catégorie de produits (3e niveau) dans la classification des produits Google. Segmenter.
category_l4	string Catégorie de produits (4e niveau) dans la classification des produits Google. Segmenter.
category_l5	string Catégorie de produits (5e niveau) dans la classification des produits Google. Segmenter.
product_type_l1	string Type de produit (1er niveau) dans la classification des produits du marchand Segmenter.
product_type_l2	string Type de produit (2e niveau) dans la classification des produits du marchand Segmenter.
product_type_l3	string Type de produit (3e niveau) dans la classification des produits du marchand Segmenter.
product_type_l4	string Type de produit (4e niveau) dans la classification des produits du marchand Segmenter.
product_type_l5	string Type de produit (5e niveau) dans la classification des produits du marchand Segmenter.
custom_label0	string Étiquette personnalisée 0 pour un regroupement de produits personnalisé. Segmenter.
custom_label1	string Étiquette personnalisée 1 pour un regroupement de produits personnalisé. Segmenter.
custom_label2	string Étiquette personnalisée 2 pour un regroupement de produits personnalisé. Segmenter.
custom_label3	string Étiquette personnalisée 3 pour un regroupement de produits personnalisé. Segmenter.
custom_label4	string Étiquette personnalisée 4 pour un regroupement de produits personnalisé. Segmenter.
clicks	int64 Nombre de clics. Métrique.
impressions	int64 Nombre de fois où les produits du marchand ont été diffusés. Métrique.
click_through_rate	double Taux de clics : nombre de clics (clics) sur les produits du marchand divisé par le nombre d'affichages (impressions) des produits. Métrique.
conversions	double Nombre de conversions attribuées au produit, enregistrées le jour de la conversion. En fonction du modèle d'attribution, une conversion peut être répartie sur plusieurs clics, où chaque clic reçoit son propre crédit. Cette métrique correspond à la somme de tous ces crédits. Métrique. Disponible uniquement pour la source de trafic FREE.
conversion_rate	double Nombre de conversions divisé par le nombre de clics, enregistré le jour de l'impression. Métrique. Disponible uniquement pour la source de trafic FREE.

ProductView

Champs disponibles pour les requêtes dans la table product_view.

Produits dans l'inventaire actuel. Les produits de ce tableau sont identiques à ceux de la sous-API Products, mais les attributs de produit de la sous-API Products ne peuvent pas tous être interrogés dans ce tableau. Contrairement à la sous-API Products, ce tableau permet de filtrer la liste de produits renvoyée par attributs. Pour récupérer un seul produit par id ou répertorier tous les produits, vous devez utiliser la sous-API Products.

Les valeurs ne sont définies que pour les champs demandés explicitement dans la requête de recherche de la requête.

Champs
price	Price Prix du produit. Absent si les informations sur le prix du produit ne sont pas disponibles.
gtin[]	string Liste des codes d'articles internationaux GTIN (Global Trade Item Number) du produit.
creation_time	Timestamp Heure à laquelle le marchand a créé le produit, en secondes.
expiration_date	Date Date d'expiration du produit, spécifiée lors de l'insertion.
item_issues[]	ItemIssue Liste des problèmes affectant les articles du produit. Ce champ ne peut pas être utilisé pour trier les résultats. Seuls les attributs sélectionnés dans ce champ (par exemple, item_issues.severity.aggregated_severity) peuvent être utilisés pour filtrer les résultats.
click_potential	ClickPotential Estimation des performances potentielles par rapport aux produits les plus performants du marchand.
id	string Identifiant REST du produit, au format channel~languageCode~feedLabel~offerId. Les méthodes d'API Merchant Center qui agissent sur les produits le prennent comme paramètre name. Obligatoire dans la clause SELECT.
channel	ChannelEnum Canal du produit. Il peut s'agir de ONLINE ou LOCAL.
language_code	string Code de langue du produit au format BCP 47.
feed_label	string Libellé du flux du produit.
offer_id	string ID du produit fourni par le marchand.
title	string Titre du produit.
brand	string Marque du produit.
category_l1	string Catégorie du produit (1er niveau) dans la classification des produits Google.
category_l2	string Catégorie du produit (2e niveau) dans la classification des produits Google.
category_l3	string Catégorie du produit (3e niveau) dans la classification des produits Google.
category_l4	string Catégorie du produit (4e niveau) dans la classification des produits Google.
category_l5	string Catégorie du produit (5e niveau) dans la classification des produits Google.
product_type_l1	string Type de produit (1er niveau) dans la classification des produits propre au marchand.
product_type_l2	string Type de produit (2e niveau) dans la classification des produits propre au marchand.
product_type_l3	string Type de produit (3e niveau) dans la classification des produits propre au marchand.
product_type_l4	string Type de produit (4e niveau) dans la classification des produits propre au marchand.
product_type_l5	string Type de produit (5e niveau) dans la classification des produits propre au marchand.
condition	string L'état du produit.
availability	string La disponibilité du produit.
shipping_label	string Étiquette de livraison normalisée spécifiée dans la source de données.
item_group_id	string Identifiant de groupe d'articles fourni par le marchand pour regrouper les variantes.
thumbnail_link	string Lien vers l'image traitée du produit, hébergée sur l'infrastructure de Google.
aggregated_reporting_context_status	AggregatedReportingContextStatus État agrégé.
click_potential_rank	int64 Classement du produit en fonction de son potentiel de clics. Un produit avec une valeur click_potential_rank 1 présente le potentiel de clics le plus élevé parmi les produits du marchand qui remplissent les conditions de la requête de recherche.

AggregatedReportingContextStatus

État du produit agrégé pour tous les contextes de reporting.

Voici un exemple de calcul de l'état cumulé:

Fiches gratuites	Annonces Shopping	État
Approuvée	Approuvée	ELIGIBLE
Approuvée	En attente	ELIGIBLE
Approuvée	Refusé	ELIGIBLE_LIMITED
En attente	En attente	EN ATTENTE
Refusé	Refusé	NOT_ELIGIBLE_OR_DISAPPROVED

Enums
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED	Non spécifié.
NOT_ELIGIBLE_OR_DISAPPROVED	Le produit n'est pas éligible ou a été refusé pour tous les contextes de reporting.
PENDING	L'état du produit est en attente dans tous les contextes de reporting.
ELIGIBLE_LIMITED	Le produit est éligible pour certains contextes de reporting (mais pas tous).
ELIGIBLE	Le produit est éligible pour tous les contextes de reporting.

ClickPotential

Le potentiel de clics d'un produit est une estimation de ses performances potentielles par rapport aux produits les plus performants du marchand. Le potentiel de clics d'un produit aide les marchands à identifier les produits à corriger en priorité et à comprendre leurs performances comparées à leur potentiel.

Enums
CLICK_POTENTIAL_UNSPECIFIED	Impact inconnu des clics prévus.
LOW	Susceptible de recevoir un faible nombre de clics par rapport aux produits les plus performants du marchand.
MEDIUM	Susceptible de recevoir un nombre modéré de clics par rapport aux produits les plus performants du marchand.
HIGH	Susceptible de recevoir un nombre similaire de clics par rapport aux produits les plus performants du marchand.

ItemIssue

Problème lié à l'article.

Champs
type	ItemIssueType Type de problème concernant l'article.
severity	ItemIssueSeverity Niveau de gravité du problème concernant l'article.
resolution	ItemIssueResolution Résolution des problèmes liés aux articles.

ItemIssueResolution

Comment résoudre le problème ?

Enums
ITEM_ISSUE_RESOLUTION_UNSPECIFIED	Non spécifié.
MERCHANT_ACTION	Le marchand doit résoudre le problème.
PENDING_PROCESSING	Le problème sera résolu automatiquement (par exemple, grâce à l'exploration des images) ou par le biais d'un examen effectué par Google. Aucune action n'est requise de la part du marchand pour le moment. Cela peut entraîner un autre problème (par exemple, en cas d'échec de l'exploration).

ItemIssueSeverity

Indique l'impact du problème sur la diffusion du produit.

Champs
severity_per_reporting_context[]	IssueSeverityPerReportingContext Gravité du problème en fonction du contexte de signalement
aggregated_severity	AggregatedIssueSeverity Gravité agrégée du problème pour tous les contextes des rapports concernés. Ce champ peut être utilisé pour filtrer les résultats.

AggregatedIssueSeverity

Gravité des problèmes agrégée pour tous les contextes de signalement.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED	Non spécifié.
DISAPPROVED	Le produit est refusé en raison de ce problème dans au moins un contexte de signalement.
DEMOTED	Ce problème rétrograde le produit dans tous les contextes de signalement concernés.
PENDING	Résolution du problème : PENDING_PROCESSING.

IssueSeverityPerReportingContext

Gravité du problème en fonction du contexte de signalement

Champs
disapproved_countries[]	string Liste des pays refusés dans le contexte de la création de rapports, représentés au format ISO 3166.
demoted_countries[]	string Liste des pays rétrogradés dans le contexte de la création de rapports, représentés au format ISO 3166.
reporting_context	ReportingContextEnum Contexte du signalement auquel le problème s'applique

ItemIssueType

Type de problème.

Champs
code	string Code d'erreur du problème, équivalent au code des problèmes liés aux produits.
canonical_attribute	string Nom d'attribut canonique pour les problèmes spécifiques à un attribut.

RelativeDemand

Ce type ne comporte aucun champ.

Demande relative pour un groupe de produits ou une marque dans le rapport "Meilleures ventes".

RelativeDemandEnum

Valeurs de la demande relatives.

Enums
RELATIVE_DEMAND_ENUM_UNSPECIFIED	Non spécifié.
VERY_LOW	La demande correspond à 0 à 5% de la demande pour le groupe de produits ou la marque les mieux classés.
LOW	La demande représente 6 à 10% de la demande pour le groupe de produits ou la marque les mieux classés.
MEDIUM	La demande représente 11 à 20% de la demande pour le groupe de produits ou la marque les mieux classés.
HIGH	La demande représente 21 à 50% de la demande pour le groupe de produits ou la marque les mieux classés.
VERY_HIGH	La demande correspond à 51 à 100% de la demande pour le groupe de produits ou la marque les mieux classés.

RelativeDemandChangeType

Ce type ne comporte aucun champ.

Demande relative d'un groupe de produits ou d'une marque dans le rapport "Meilleures ventes" par rapport à la période précédente.

RelativeDemandChangeTypeEnum

Valeurs de type d'évolution de la demande relative.

Enums
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED	Non spécifié.
SINKER	La demande relative est inférieure à la période précédente.
FLAT	La demande relative est égale à la période précédente.
RISER	La demande relative est plus élevée que la période précédente.

ReportGranularity

Ce type ne comporte aucun champ.

Précision du rapport "Meilleures ventes" Les rapports "Meilleures ventes" sont calculés sur une période d'une semaine et d'un mois.

ReportGranularityEnum

Valeurs de précision des rapports

Enums
REPORT_GRANULARITY_ENUM_UNSPECIFIED	Non spécifié.
WEEKLY	Le rapport est calculé sur une période d'une semaine.
MONTHLY	Le rapport est calculé sur une période d'un mois.

ReportRow

Ligne de résultats renvoyée par la requête de recherche.

Seul le message correspondant à la table interrogée est renseigné dans la réponse. Dans le message renseigné, seuls les champs explicitement demandés dans la requête sont renseignés.

Champs
product_performance_view	ProductPerformanceView Champs disponibles pour les requêtes dans la table product_performance_view.
non_product_performance_view	NonProductPerformanceView Champs disponibles pour les requêtes dans la table non_product_performance_view.
product_view	ProductView Champs disponibles pour les requêtes dans la table product_view.
price_competitiveness_product_view	PriceCompetitivenessProductView Champs disponibles pour les requêtes dans la table price_competitiveness_product_view.
price_insights_product_view	PriceInsightsProductView Champs disponibles pour les requêtes dans la table price_insights_product_view.
best_sellers_product_cluster_view	BestSellersProductClusterView Champs disponibles pour les requêtes dans la table best_sellers_product_cluster_view.
best_sellers_brand_view	BestSellersBrandView Champs disponibles pour les requêtes dans la table best_sellers_brand_view.
competitive_visibility_competitor_view	CompetitiveVisibilityCompetitorView Champs disponibles pour les requêtes dans la table competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view	CompetitiveVisibilityTopMerchantView Champs disponibles pour les requêtes dans la table competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view	CompetitiveVisibilityBenchmarkView Champs disponibles pour les requêtes dans la table competitive_visibility_benchmark_view.

SearchRequest

Message de requête pour la méthode ReportService.Search.

Champs
parent	string Obligatoire. Identifiant du compte effectuant l'appel. Il doit s'agir d'un compte individuel ou d'un sous-compte de MC. Format: accounts/{account}
query	string Obligatoire. Requête qui définit un rapport à récupérer. Pour plus de détails sur la façon de créer votre requête, consultez le guide du langage de requête. Pour obtenir la liste complète des tables et des champs disponibles, consultez la section "Champs disponibles".
page_size	int32 Facultatif. Nombre de ReportRows à récupérer sur une seule page. La valeur par défaut est 1 000. Les valeurs supérieures à 5 000 sont forcées à 5 000.
page_token	string Facultatif. Jeton de la page à récupérer. Si aucune valeur n'est spécifiée, la première page de résultats est renvoyée. Pour demander la page de résultats suivante, la valeur obtenue à partir de next_page_token dans la réponse précédente doit être utilisée.

SearchResponse

Message de réponse pour la méthode ReportService.Search.

Champs
results[]	ReportRow Lignes correspondant à la requête de recherche.
next_page_token	string Jeton qui peut être envoyé en tant que page_token pour récupérer la page suivante. S'il est omis, il n'y a pas de pages suivantes.

TrafficSource

Ce type ne comporte aucun champ.

Source de trafic des impressions dans le rapport "Visibilité sur vos concurrents".

TrafficSourceEnum

Valeurs des sources de trafic.

Enums
TRAFFIC_SOURCE_ENUM_UNSPECIFIED	Non spécifié.
ORGANIC	Trafic généré par les résultats naturels.
ADS	Trafic généré par les annonces.
ALL	Trafic généré par les résultats naturels et les annonces