Method: customers.generateKeywordHistoricalMetrics

Renvoie une liste des métriques historiques des mots clés.

Liste des erreurs générées: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Requête HTTP

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordHistoricalMetrics

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

ID du client associé à la recommandation.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
Champs
keywords[]

string

Liste des mots clés pour lesquels obtenir des métriques historiques. En raison de la déduplication quasi exacte, toutes les entrées ne seront pas renvoyées. Par exemple, si vous demandez des statistiques pour "voiture" et "voitures", seul "voiture" sera renvoyé. Vous pouvez utiliser jusqu'à 10 000 mots clés.
includeAdultKeywords

boolean

Si la valeur est "true", les mots clés réservés aux adultes sont inclus dans la réponse. La valeur par défaut est false.
geoTargetConstants[]

string

Noms des ressources de l'établissement à cibler. Le maximum est de 10. Une liste vide peut être utilisée pour spécifier toutes les zones géographiques de ciblage.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Réseau de ciblage. Si ce paramètre n'est pas défini, le Réseau de Recherche et les sites partenaires de Google est utilisé.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Champs agrégés à inclure dans la réponse.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Options pour les données historiques des métriques.
language

string

Nom de la ressource de la langue à cibler. Chaque mot clé appartient à un ensemble de langues. Un mot clé est inclus si la langue est l'une de celles de l'ensemble. Si ce paramètre n'est pas défini, tous les mots clés sont inclus.

Corps de la réponse

Message de réponse pour KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Champs
results[]

object (GenerateKeywordHistoricalMetricsResult)

Liste des mots clés et de leurs métriques historiques.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Métriques agrégées pour tous les mots clés.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/adwords

Pour en savoir plus, consultez OAuth 2.0 Overview.

GenerateKeywordHistoricalMetricsResult

Résultat de la génération des métriques historiques des mots clés.

Représentation JSON 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
Champs
closeVariants[]

string

Liste des variantes proches des mots clés demandés dont les statistiques sont combinées dans GenerateKeywordHistoricalMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Métriques historiques pour le texte et ses variantes proches
text

string

Texte de la requête associé à un ou plusieurs mots clés. Notez que nous supprimons les doublons de votre liste de mots clés, en éliminant les variantes proches avant de renvoyer les mots clés sous forme de texte. Par exemple, si votre requête contenait à l'origine les mots clés "voiture" et "voitures", la requête de recherche renvoyée ne contiendra que "voitures". La liste des requêtes dédupliquées sera incluse dans le champ "closeVariants".