REST Resource: accounts.reports

Ressource: 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.

Représentation JSON 
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
Champs
productPerformanceView

object (ProductPerformanceView)

Champs disponibles pour les requêtes dans le tableau productPerformanceView.
nonProductPerformanceView

object (NonProductPerformanceView)

Champs disponibles pour les requêtes dans le tableau nonProductPerformanceView.
productView

object (ProductView)

Champs disponibles pour les requêtes dans le tableau productView.
priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Champs disponibles pour les requêtes dans le tableau priceCompetitivenessProductView.
priceInsightsProductView

object (PriceInsightsProductView)

Champs disponibles pour les requêtes dans le tableau priceInsightsProductView.
bestSellersProductClusterView

object (BestSellersProductClusterView)

Champs disponibles pour les requêtes dans le tableau bestSellersProductClusterView.
bestSellersBrandView

object (BestSellersBrandView)

Champs disponibles pour les requêtes dans le tableau bestSellersBrandView.
competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Champs disponibles pour les requêtes dans le tableau competitiveVisibilityCompetitorView.
competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Champs disponibles pour les requêtes dans le tableau competitiveVisibilityTopMerchantView.
competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

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

ProductPerformanceView

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

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, offerId). Les valeurs des dimensions de produit, comme offerId, 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.

Représentation JSON 
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
Champs
date

object (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

object (Date)

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

object (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.
marketingMethod

enum (MarketingMethodEnum)

Méthode marketing à laquelle les métriques s'appliquent. Segmenter.
customerCountryCode

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é.
offerId

string

Identifiant du produit fourni par le marchand. Segmenter.
title

string

Titre du produit. Segmenter.
brand

string

Marque du produit. Segmenter.
categoryL1

string

Catégorie de produits (1er niveau) de la classification des produits Google. Segmenter.
categoryL2

string

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

string

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

string

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

string

Catégorie de produits (5e niveau) de la classification des produits Google. Segmenter.
productTypeL1

string

Type de produit (1er niveau) dans la classification des produits du marchand. Segmenter.
productTypeL2

string

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

string

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

string

Type de produit (4e niveau) dans la classification des produits du marchand. Segmenter.
productTypeL5

string

Type de produit (5e niveau) dans la classification des produits du marchand. Segmenter.
customLabel0

string

Étiquette personnalisée 0 pour un regroupement personnalisé de produits. Segmenter.
customLabel1

string

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

string

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

string

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

string

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

string (int64 format)

Nombre de clics. Métrique.
impressions

string (int64 format)

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

number

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

number

Nombre de conversions attribuées au produit, enregistrées à 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.
conversionRate

number

Nombre de conversions divisé par le nombre de clics, indiqué à la date de l'impression. Métrique.

Disponible uniquement pour la source de trafic FREE.

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 nonProductPerformanceView.

Données sur les performances des images et des liens vers votre boutique en ligne qui redirigent 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.

Représentation JSON 
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Champs
date

object (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

object (Date)

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

string (int64 format)

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

string (int64 format)

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.
clickThroughRate

number

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.

ProductView

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

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.

Représentation JSON 
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
Champs
price

object (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.
creationTime

string (Timestamp format)

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

object (Date)

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

object (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, itemIssues.severity.aggregated_severity) peuvent être utilisés pour filtrer les résultats.
clickPotential

enum (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

enum (ChannelEnum)

Canal du produit. Il peut s'agir de ONLINE ou LOCAL.
languageCode

string

Code de langue du produit au format BCP 47.
feedLabel

string

Libellé du flux du produit.
offerId

string

Identifiant du produit fourni par le marchand.
title

string

Titre du produit.
brand

string

Marque du produit.
categoryL1

string

Catégorie du produit (1er niveau) dans la classification des produits Google.
categoryL2

string

Catégorie du produit (2e niveau) dans la classification des produits Google.
categoryL3

string

Catégorie du produit (3e niveau) dans la classification des produits Google.
categoryL4

string

Catégorie du produit (4e niveau) dans la classification des produits Google.
categoryL5

string

Catégorie du produit (5e niveau) dans la classification des produits Google.
productTypeL1

string

Type de produit (1er niveau) dans la taxonomie des produits du marchand.
productTypeL2

string

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

string

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

string

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

string

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

string

État du produit.
availability

string

Disponibilité du produit.
shippingLabel

string

Étiquette de livraison normalisée spécifiée dans la source de données.
itemGroupId

string

Identifiant de groupe d'articles fourni par le marchand pour regrouper les variantes.
aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

État agrégé.
clickPotentialRank

string (int64 format)

Classement du produit en fonction de son potentiel de clics. Un produit avec clickPotentialRank 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.

ItemIssue

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

Représentation JSON 
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Champs
type

object (ItemIssueType)

Type de problème concernant l'article.
severity

object (ItemIssueSeverity)

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

enum (ItemIssueResolution)

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

ItemIssueType

Type de problème.

Représentation JSON 
{
  "code": string,
  "canonicalAttribute": string
}
Champs
code

string

Code d'erreur du problème, équivalent à code dans Problèmes liés aux produits.
canonicalAttribute

string

Nom d'attribut canonique pour les problèmes spécifiques à un attribut.

ItemIssueSeverity

Indique comment le problème affecte la diffusion du produit

Représentation JSON 
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Champs
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

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

enum (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.

IssueSeverityPerReportingContext

Gravité du problème par contexte des rapports.

Représentation JSON 
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Champs
disapprovedCountries[]

string

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

string

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

enum (ReportingContextEnum)

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

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.

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 d'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).

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.

PriceCompetitivenessProductView

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

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.

Représentation JSON 
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
Champs
price

object (Price)

Prix actuel du produit.
benchmarkPrice

object (Price)

Dernier benchmark de prix disponible pour le catalogue du produit dans le pays de référence.
reportCountryCode

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. Peut être utilisé pour joindre des données à la table productView.

Obligatoire dans la clause SELECT.
offerId

string

Identifiant du produit fourni par le marchand.
title

string

Titre du produit.
brand

string

Marque du produit.
categoryL1

string

Catégorie du produit (1er niveau) dans la classification des produits Google.
categoryL2

string

Catégorie du produit (2e niveau) dans la classification des produits Google.
categoryL3

string

Catégorie du produit (3e niveau) dans la classification des produits Google.
categoryL4

string

Catégorie du produit (4e niveau) dans la classification des produits Google.
categoryL5

string

Catégorie du produit (5e niveau) dans la classification des produits Google.
productTypeL1

string

Type de produit (1er niveau) dans la taxonomie des produits du marchand.
productTypeL2

string

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

string

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

string

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

string

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

PriceInsightsProductView

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

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.

Représentation JSON 
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
Champs
price

object (Price)

Prix actuel du produit.
suggestedPrice

object (Price)

Dernier prix suggéré pour le produit.
effectiveness

enum (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. Peut être utilisé pour joindre des données à la table productView.

Obligatoire dans la clause SELECT.
offerId

string

Identifiant du produit fourni par le marchand.
title

string

Titre du produit.
brand

string

Marque du produit.
categoryL1

string

Catégorie du produit (1er niveau) dans la classification des produits Google.
categoryL2

string

Catégorie du produit (2e niveau) dans la classification des produits Google.
categoryL3

string

Catégorie du produit (3e niveau) dans la classification des produits Google.
categoryL4

string

Catégorie du produit (4e niveau) dans la classification des produits Google.
categoryL5

string

Catégorie du produit (5e niveau) dans la classification des produits Google.
productTypeL1

string

Type de produit (1er niveau) dans la taxonomie des produits du marchand.
productTypeL2

string

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

string

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

string

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

string

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

number

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.
predictedClicksChangeFraction

number

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.
predictedConversionsChangeFraction

number

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.

BestSellersProductClusterView

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

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.

Représentation JSON 
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Champs
reportDate

object (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 reportDate n'est spécifiée dans la requête, le dernier rapport hebdomadaire ou mensuel disponible est renvoyé.
variantGtins[]

string

Codes GTIN d'exemples de variantes du cluster de produits.
reportGranularity

enum (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 reportGranularity est obligatoire dans la clause WHERE.
reportCountryCode

string

Pays dans lequel le classement est calculé. Représenté au format ISO 3166.

Obligatoire dans la clause SELECT. La condition sur reportCountryCode est obligatoire dans la clause WHERE.
reportCategoryId

string (int64 format)

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 reportCategoryId 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.
categoryL1

string

Catégorie de produits (1er niveau) du cluster de produits, représentée dans la classification des produits Google.
categoryL2

string

Catégorie de produits (2e niveau) du cluster de produits, représentée dans la classification des produits Google.
categoryL3

string

Catégorie de produits (3e niveau) du cluster de produits, représentée dans la classification des produits Google.
categoryL4

string

Catégorie de produits (4e niveau) du cluster de produits, représentée dans la classification des produits Google.
categoryL5

string

Catégorie de produits (5e niveau) du cluster de produits, représentée dans la classification des produits Google.
inventoryStatus

enum (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".
brandInventoryStatus

enum (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

string (int64 format)

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.
previousRank

string (int64 format)

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

enum (RelativeDemandEnum)

Demande estimée par rapport au cluster de produits le plus populaire dans la même catégorie et le même pays.
previousRelativeDemand

enum (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.
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

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

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.

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.

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.

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 supérieure à celle de la période précédente.

BestSellersBrandView

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

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.

Représentation JSON 
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Champs
reportDate

object (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 reportDate n'est spécifiée dans la requête, le dernier rapport hebdomadaire ou mensuel disponible est renvoyé.
reportGranularity

enum (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 reportGranularity est obligatoire dans la clause WHERE.
reportCountryCode

string

Pays dans lequel le classement est calculé. Représenté au format ISO 3166.

Obligatoire dans la clause SELECT. La condition sur reportCountryCode est obligatoire dans la clause WHERE.
reportCategoryId

string (int64 format)

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 reportCategoryId 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

string (int64 format)

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.
previousRank

string (int64 format)

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

enum (RelativeDemandEnum)

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

enum (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.
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

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

CompetitiveVisibilityCompetitorView

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

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.

Représentation JSON 
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
Champs
date

object (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 "isYourDomain" est défini sur "true".

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

boolean

"True" si cette ligne contient des données pour votre domaine.

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

string

Pays dans lequel les impressions sont apparues.

Obligatoire dans la clause SELECT. Une condition sur reportCountryCode est requise dans la clause WHERE.
reportCategoryId

string (int64 format)

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 reportCategoryId est requise dans la clause WHERE.
trafficSource

enum (TrafficSourceEnum)

Source de trafic des impressions.

Obligatoire dans la clause SELECT.
rank

string (int64 format)

Position du domaine dans le classement des établissements similaires pour les clés sélectionnées (date, reportCategoryId, reportCountryCode, trafficSource) en fonction du nombre d'impressions. 1 est la valeur la plus élevée.

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

number

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.
pageOverlapRate

number

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.
higherPositionRate

number

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.
relativeVisibility

number

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.

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.

CompetitiveVisibilityTopMerchantView

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

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.

Représentation JSON 
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Champs
date

object (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 "isYourDomain" est défini sur "true".

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

boolean

"True" si cette ligne contient des données pour votre domaine.

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

string

Pays dans lequel les impressions sont apparues.

Obligatoire dans la clause SELECT. Une condition sur reportCountryCode est requise dans la clause WHERE.
reportCategoryId

string (int64 format)

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 reportCategoryId est requise dans la clause WHERE.
trafficSource

enum (TrafficSourceEnum)

Source de trafic des impressions.

Obligatoire dans la clause SELECT.
rank

string (int64 format)

Position du domaine dans le classement des meilleurs marchands pour les clés sélectionnées (date, reportCategoryId, reportCountryCode, trafficSource) en fonction du nombre d'impressions. 1 est la valeur la plus élevée.

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

number

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.
pageOverlapRate

number

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.
higherPositionRate

number

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.

CompetitiveVisibilityBenchmarkView

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

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.

Représentation JSON 
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Champs
date

object (Date)

Date de cette ligne.

Obligatoire dans la clause SELECT. Une condition sur date est requise dans la clause WHERE.
reportCountryCode

string

Pays dans lequel les impressions sont apparues.

Obligatoire dans la clause SELECT. Une condition sur reportCountryCode est requise dans la clause WHERE.
reportCategoryId

string (int64 format)

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 reportCategoryId est requise dans la clause WHERE.
trafficSource

enum (TrafficSourceEnum)

Source de trafic des impressions.

Obligatoire dans la clause SELECT.
yourDomainVisibilityTrend

number

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.
categoryBenchmarkVisibilityTrend

number

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.

Méthodes
Récupère un rapport défini par une requête de recherche.