Package google.shopping.merchant.reports.v1beta

Index

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 OAuth 2.0 Overview.

BestSellersBrandView

Champs disponibles pour les requêtes dans le tableau best_sellers_brand_view.

Rapport Meilleures ventes avec les principales marques.

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:

  • 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

Granularité du rapport. Le classement peut être effectué sur une période d'une semaine ou d'un mois.

Obligatoire dans la clause SELECT. La condition sur report_granularity est obligatoire 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 obligatoire dans la clause WHERE.
report_category_id

int64

ID de la catégorie de produits Google pour laquelle le classement est calculé, 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 sur les surfaces Ads et naturelles, dans la catégorie et le pays sélectionnés, en fonction du nombre estimé d'unités vendues.
previous_rank

int64

Classement de la popularité au cours de la semaine ou du mois précédents.
relative_demand

RelativeDemandEnum

Demande estimée par rapport à la marque la plus populaire dans la même catégorie et le même pays.
previous_relative_demand

RelativeDemandEnum

Demande estimée par rapport à la marque la plus populaire dans la même catégorie et le même pays au cours de la semaine ou du mois précédents.
relative_demand_change

RelativeDemandChangeTypeEnum

Variation de la demande estimée. Indique si le nombre a augmenté, diminué ou est resté stable.

BestSellersProductClusterView

Champs disponibles pour les requêtes dans le tableau best_sellers_product_cluster_view.

Rapport Meilleures ventes avec les principaux clusters de produits. Un cluster de produits regroupe différentes offres et variantes représentant 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:

  • 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 d'exemples de variantes du cluster de produits.
report_granularity

ReportGranularityEnum

Granularité du rapport. Le classement peut être effectué sur une période d'une semaine ou d'un mois.

Obligatoire dans la clause SELECT. La condition sur report_granularity est obligatoire 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 obligatoire dans la clause WHERE.
report_category_id

int64

ID de la catégorie de produits Google pour laquelle le classement est calculé, 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 cluster 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 dans au moins un des pays, OUT_OF_STOCK dans votre source de données produit dans tous les pays ou NOT_IN_INVENTORY du tout.

Ce champ ne tient pas compte du filtre par pays du rapport "Meilleures ventes".
brand_inventory_status

InventoryStatus

Indique si au moins un produit de la marque est actuellement IN_STOCK dans votre source de données produit dans au moins un des pays, si tous les produits sont OUT_OF_STOCK dans votre source de données produit dans tous les pays ou si NOT_IN_INVENTORY.

Ce champ ne tient pas compte du filtre par pays du rapport "Meilleures ventes".
rank

int64

Popularité du cluster de produits dans les annonces et les surfaces naturelles, dans la catégorie et le pays sélectionnés, en fonction du nombre estimé d'unités vendues.
previous_rank

int64

Classement de la 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 au cours de la semaine ou du mois précédents.
relative_demand_change

RelativeDemandChangeTypeEnum

Variation de la demande estimée. Indique si le nombre a augmenté, diminué ou est resté stable.

InventoryStatus

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

Enums
INVENTORY_STATUS_UNSPECIFIED Non spécifié.
IN_STOCK Vous disposez d'un produit de ce cluster de produits ou de cette marque en stock.
OUT_OF_STOCK Vous avez un produit de ce groupe de produits ou de cette marque en stock, mais il est actuellement indisponible.
NOT_IN_INVENTORY Vous ne disposez d'aucun produit de ce cluster de produits ou de cette marque dans votre inventaire.

CompetitiveVisibilityBenchmarkView

Champs disponibles pour les requêtes dans le tableau competitive_visibility_benchmark_view.

Rapport Visibilité par rapport aux 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 sur 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 sur 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 sur 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é en fonction des impressions de votre domaine par rapport au début de la période sélectionnée (ou au premier jour avec des impressions non nulles).

Ne peut pas être filtré dans la clause WHERE.
category_benchmark_visibility_trend

double

Variation de la visibilité en fonction des 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 ayant la meilleure visibilité, qui représente approximativement le marché.

Ne peut pas être filtré dans la clause WHERE.

CompetitiveVisibilityCompetitorView

Champs disponibles pour les requêtes dans le tableau competitive_visibility_competitor_view.

Le rapport Visibilité par rapport aux concurrents avec les 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 sur date est requise dans la clause WHERE.
domain

string

Domaine de votre concurrent ou votre domaine, si "is_your_domain" est défini sur "true".

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 sur 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 sur 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 est la valeur la plus élevée.

Ne peut pas être filtré dans la clause WHERE.
ads_organic_ratio

double

Le ratio annonces / résultats naturels indique à quelle fréquence 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é dans des ensembles.

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 sur la même page que les vôtres.

Ne peut pas être filtré dans la clause WHERE.
higher_position_rate

double

Le taux de positions plus élevées indique à quelle fréquence l'offre d'un concurrent est apparue à une position plus élevée que celle de votre offre sur la même page.

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 d'un marchand concurrent, divisé par le nombre d'impressions que vous enregistrez au cours de la période sélectionnée pour une catégorie de produits et un pays donnés.

Ne peut pas être filtré dans la clause WHERE.

CompetitiveVisibilityTopMerchantView

Champs disponibles pour les requêtes dans le tableau competitive_visibility_top_merchant_view.

Rapport Visibilité par rapport aux concurrents avec les entreprises ayant 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 sur date est requise dans la clause WHERE.
domain

string

Domaine de votre concurrent ou votre domaine, si "is_your_domain" est défini sur "true".

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 sur 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 sur 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 meilleurs marchands pour les clés sélectionnées (date, report_category_id, report_country_code, traffic_source) en fonction du nombre d'impressions. 1 est la valeur la plus élevée.

Ne peut pas être filtré dans la clause WHERE.
ads_organic_ratio

double

Le ratio annonces / résultats naturels indique à quelle fréquence 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 sur la même page que les vôtres.

Ne peut pas être filtré dans la clause WHERE.
higher_position_rate

double

Le taux de positions plus élevées indique à quelle fréquence l'offre d'un concurrent est apparue à une position plus élevée que celle de votre offre sur la même page.

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 la 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 le tableau non_product_performance_view.

Données sur les performances des images et des liens vers votre boutique en ligne redirigeant vers vos pages hors produits. Cela inclut les métriques de performances (par exemple, clicks) et les dimensions en fonction desquelles les métriques de performances sont segmentées (par exemple, date).

Vous ne pouvez pas sélectionner des champs de segment dans des requêtes sans 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 au fuseau horaire du marchand à laquelle les métriques s'appliquent. Segmenter.

La condition sur date est obligatoire dans la clause WHERE.
week

Date

Premier jour de la semaine (lundi) de la date des métriques dans le fuseau horaire du marchand. Segmenter.
clicks

int64

Nombre de clics sur les images et les liens vers votre boutique en ligne redirigeant vers vos pages qui n'incluent pas de produits. Métrique.
impressions

int64

Nombre de fois où les images et les liens vers votre boutique en ligne redirigeant vers vos pages qui n'incluent pas de produits ont été diffusés. Métrique.
click_through_rate

double

Taux de clics : nombre de clics (clicks) divisé par le nombre d'impressions (impressions) des images et des liens vers votre boutique en ligne qui redirigent vers vos pages ne contenant pas de produits. Métrique.

PriceCompetitivenessProductView

Champs disponibles pour les requêtes dans le tableau price_competitiveness_product_view.

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 des prix. Représenté au format ISO 3166.

Obligatoire dans la clause SELECT.
id

string

ID 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

Identifiant 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 taxonomie des produits du marchand.
product_type_l2

string

Type de produit (2e niveau) dans la taxonomie des produits du marchand.
product_type_l3

string

Type de produit (3e niveau) dans la taxonomie des produits du marchand.
product_type_l4

string

Type de produit (4e niveau) dans la taxonomie des produits du marchand.
product_type_l5

string

Type de produit (5e niveau) dans la taxonomie des produits du marchand.

PriceInsightsProductView

Champs disponibles pour les requêtes dans le tableau price_insights_product_view.

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

Efficacité prévue de l'application de la suggestion de prix, répartie en catégories.
id

string

ID 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

Identifiant 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 taxonomie des produits du marchand.
product_type_l2

string

Type de produit (2e niveau) dans la classification des produits du marchand.
product_type_l3

string

Type de produit (3e niveau) dans la classification des produits du marchand.
product_type_l4

string

Type de produit (4e niveau) dans la taxonomie des produits du marchand.
product_type_l5

string

Type de produit (5e niveau) dans la taxonomie des produits du marchand.
predicted_impressions_change_fraction

double

Variation prévue du nombre d'impressions sous forme de fraction après l'application du prix suggéré par rapport au prix actuel en vigueur. Par exemple, 0,05 correspond à une augmentation prévue de 5% du nombre d'impressions.
predicted_clicks_change_fraction

double

Variation prévue du nombre de clics sous forme de fraction après l'application du prix suggéré par rapport au prix actuel en vigueur. Par exemple, 0,05 correspond à une augmentation prévue de 5% du nombre de clics.
predicted_conversions_change_fraction

double

Variation prévue du nombre de conversions sous forme de fraction après l'introduction du prix suggéré par rapport au prix actuel actif. Par exemple, 0,05 correspond à une augmentation prévue de 5% du nombre de conversions).

Efficacité

Ensemble d'efficacité prévue.

L'efficacité indique quels produits 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 de la différence entre le prix actuel et le prix suggéré. Les suggestions de prix dont l'efficacité est HIGH sont susceptibles d'entraîner la plus forte amélioration des performances.

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

ProductPerformanceView

Champs disponibles pour les requêtes dans le tableau product_performance_view.

Données sur les performances des produits de votre compte, y compris les métriques de performances (par exemple, clicks) et les dimensions en fonction desquelles les métriques de performances sont segmentées (par exemple, offer_id). Les valeurs des dimensions de produit, comme offer_id, reflètent l'état d'un produit au moment de l'impression.

Vous ne pouvez pas sélectionner des champs de segment dans des requêtes sans 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 au fuseau horaire du marchand à laquelle les métriques s'appliquent. Segmenter.

La condition sur date est obligatoire dans la clause WHERE.
week

Date

Premier jour de la semaine (lundi) de la date des métriques dans le fuseau horaire du marchand. Segmenter.
conversion_value

Price

Valeur des conversions attribuées au produit, comptabilisée à la date 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

Identifiant 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) de la classification des produits Google. Segmenter.
category_l2

string

Catégorie de produits (2e niveau) de la classification des produits Google. Segmenter.
category_l3

string

Catégorie de produits (3e niveau) de la classification des produits Google. Segmenter.
category_l4

string

Catégorie de produits (4e niveau) de la classification des produits Google. Segmenter.
category_l5

string

Catégorie de produits (5e niveau) de 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 personnalisé de produits. Segmenter.
custom_label1

string

Étiquette personnalisée 1 pour un regroupement personnalisé de produits. Segmenter.
custom_label2

string

Étiquette personnalisée 2 pour regrouper des produits. Segmenter.
custom_label3

string

Étiquette personnalisée 3 pour regrouper des produits. Segmenter.
custom_label4

string

Étiquette personnalisée 4 pour regrouper des produits. Segmenter.
clicks

int64

Nombre de clics. Métrique.
impressions

int64

Nombre de fois où les produits du marchand sont diffusés. Métrique.
click_through_rate

double

Taux de clics : nombre de clics enregistrés par les produits d'un marchand (clics) divisé par le nombre de fois où les produits sont diffusés (impressions). Métrique.
conversions

double

Nombre de conversions attribuées au produit, indiqué à la date de la conversion. Selon le modèle d'attribution, une conversion peut être répartie entre plusieurs clics, chacun recevant 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, calculé à la date de l'impression. Métrique.

Disponible uniquement pour la source de trafic FREE.

ProductView

Champs disponibles pour les requêtes dans le tableau product_view.

Produits de l'inventaire actuel. Les produits de ce tableau sont les mêmes que ceux de la sous-API Products, mais tous les attributs de produit de la sous-API Products ne sont pas disponibles pour les requêtes dans ce tableau. Contrairement à la sous-API Products, ce tableau permet de filtrer la liste des produits renvoyés par attributs. Pour récupérer un seul produit par id ou lister 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 article international (GTIN) du produit.
creation_time

Timestamp

Heure de création du produit par le marchand, au format code temporel (en secondes).
expiration_date

Date

Date d'expiration du produit, spécifiée lors de l'insertion.
item_issues[]

ItemIssue

Liste des problèmes liés aux articles du produit.

Vous ne pouvez pas utiliser ce champ pour trier les résultats.

Seuls certains attributs de ce champ (par exemple, item_issues.severity.aggregated_severity) peuvent être utilisés pour filtrer les résultats.
click_potential

ClickPotential

Estimation du potentiel de performances par rapport aux produits les plus performants du marchand.
id

string

ID REST du produit, au format channel~languageCode~feedLabel~offerId Les méthodes de l'API Merchant 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

Identifiant 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 taxonomie des produits du marchand.
product_type_l2

string

Type de produit (2e niveau) dans la taxonomie des produits du marchand.
product_type_l3

string

Type de produit (3e niveau) dans la taxonomie des produits du marchand.
product_type_l4

string

Type de produit (4e niveau) dans la taxonomie des produits du marchand.
product_type_l5

string

Type de produit (5e niveau) dans la taxonomie des produits du marchand.
condition

string

État du produit.
availability

string

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.
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 click_potential_rank 1 a le potentiel de clics le plus élevé parmi les produits du marchand qui répondent aux conditions de la requête de recherche.

AggregatedReportingContextStatus

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

Voici un exemple de calcul de l'état agrégé:

Fiches gratuites Annonces Shopping État
Approuvé Approuvé ELIGIBLE
Approuvé En attente ELIGIBLE
Approuvé 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 rapport.
PENDING L'état du produit est "En attente" dans tous les contextes de rapport.
ELIGIBLE_LIMITED Le produit est éligible à certains contextes de création de rapports, mais pas à tous.
ELIGIBLE Le produit est éligible à 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. Il aide les marchands à déterminer quels produits corriger en priorité et à comprendre leurs performances comparées à leur potentiel.

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

ItemIssue

Problème lié à l'article associé au produit.

Champs
type

ItemIssueType

Type de problème concernant l'article.
severity

ItemIssueSeverity

Gravité du problème lié à l'article.
resolution

ItemIssueResolution

Résolution du problème lié à l'article.

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, par l'exploration des images) ou par un examen de Google. Aucune action n'est requise de la part du marchand pour le moment. La résolution peut entraîner un autre problème (par exemple, si l'exploration échoue).

ItemIssueSeverity

Indique comment le problème affecte la diffusion du produit

Champs
severity_per_reporting_context[]

IssueSeverityPerReportingContext

Gravité du problème par contexte des rapports.
aggregated_severity

AggregatedIssueSeverity

Gravité agrégée du problème pour tous les contextes des rapports concernés.

Ce champ permet de filtrer les résultats.

AggregatedIssueSeverity

Gravité du problème agrégée pour tous les contextes de rapport.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Non spécifié.
DISAPPROVED Le problème entraîne le refus du produit dans au moins un contexte de création de rapports.
DEMOTED Le problème rétrograde le produit dans tous les contextes de rapports concernés.
PENDING La résolution du problème est PENDING_PROCESSING.

IssueSeverityPerReportingContext

Gravité du problème par contexte des rapports.

Champs
disapproved_countries[]

string

Liste des pays refusés dans le contexte des rapports, représentée au format ISO 3166
demoted_countries[]

string

Liste des pays rétrogradés dans le contexte des rapports, représentée au format ISO 3166
reporting_context

ReportingContextEnum

Contexte des rapports auquel le problème s'applique.

ItemIssueType

Type de problème.

Champs
code

string

Code d'erreur du problème, équivalent à code dans 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 d'un cluster de produits ou d'une marque dans le rapport "Meilleures ventes".

RelativeDemandEnum

Valeurs de la demande relative.

Enums
RELATIVE_DEMAND_ENUM_UNSPECIFIED Non spécifié.
VERY_LOW La demande représente 0 à 5% de la demande pour le cluster de produits ou la marque le plus populaire.
LOW La demande représente 6 à 10% de la demande pour le cluster de produits ou la marque le plus populaire.
MEDIUM La demande représente 11 à 20% de la demande pour le cluster de produits ou la marque le plus populaire.
HIGH La demande représente 21 à 50% de la demande pour le cluster de produits ou la marque le plus populaire.
VERY_HIGH La demande représente 51 à 100% de la demande pour le cluster de produits ou la marque le plus populaire.

RelativeDemandChangeType

Ce type ne comporte aucun champ.

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

RelativeDemandChangeTypeEnum

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

Enums
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Non spécifié.
SINKER La demande relative est inférieure à celle de la période précédente.
FLAT La demande relative est égale à celle de la période précédente.
RISER La demande relative est plus élevée que pour 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ésultat renvoyée par la requête de recherche.

Seul le message correspondant au tableau interrogé 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 le tableau product_performance_view.
non_product_performance_view

NonProductPerformanceView

Champs disponibles pour les requêtes dans le tableau non_product_performance_view.
product_view

ProductView

Champs disponibles pour les requêtes dans le tableau product_view.
price_competitiveness_product_view

PriceCompetitivenessProductView

Champs disponibles pour les requêtes dans le tableau price_competitiveness_product_view.
price_insights_product_view

PriceInsightsProductView

Champs disponibles pour les requêtes dans le tableau price_insights_product_view.
best_sellers_product_cluster_view

BestSellersProductClusterView

Champs disponibles pour les requêtes dans le tableau best_sellers_product_cluster_view.
best_sellers_brand_view

BestSellersBrandView

Champs disponibles pour les requêtes dans le tableau best_sellers_brand_view.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

Champs disponibles pour les requêtes dans le tableau competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

Champs disponibles pour les requêtes dans le tableau competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

Champs disponibles pour les requêtes dans le tableau competitive_visibility_benchmark_view.

SearchRequest

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

Champs
parent

string

Obligatoire. ID du compte à l'origine de 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 savoir comment 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. Valeur par défaut : 1 000. Les valeurs supérieures à 5 000 sont réduites à 5 000.
page_token

string

Facultatif. Jeton de la page à récupérer. Si cette option n'est pas spécifiée, la première page de résultats est renvoyée. Pour demander la page de résultats suivante, vous devez utiliser la valeur obtenue à partir de next_page_token dans la réponse précédente.

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 pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si cet attribut est omis, aucune page suivante n'existe.

TrafficSource

Ce type ne comporte aucun champ.

Source de trafic des impressions dans le rapport "Visibilité par rapport aux 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 provenant des annonces.
ALL Trafic généré par les résultats naturels et par les annonces.