Method: customers.generateKeywordHistoricalMetrics

Renvoie une liste de métriques historiques pour les 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/v16/customers/{customerId}:generateKeywordHistoricalMetrics

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Identifiant 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 de mots clés pour obtenir des métriques historiques. La déduplication quasi exacte ne renverra pas toutes les entrées. Par exemple, si les statistiques pour "voiture" et "voitures" sont demandées, seul le mot "voiture" est 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 seront inclus dans la réponse. La valeur par défaut est "false".
geoTargetConstants[]

string

Noms de ressources de la zone géographique à cibler. La valeur maximale est 10. Une liste vide PEUT être utilisée pour spécifier toutes les zones géographiques de ciblage.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Ciblage du réseau. Si cette règle n'est pas configurée, nous utilisons le Réseau de Recherche de Google et le réseau des partenaires.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

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

object (HistoricalMetricsOptions)

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

string

Nom de ressource de la langue à cibler. Chaque mot clé est associé à un ensemble de langues. Un mot clé est inclus si la langue fait partie des langues qui lui sont associées. Si cette règle n'est pas configurée, 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 de mots clés et historique des métriques associées
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 la présentation d'OAuth 2.0.

GenerateKeywordHistoricalMetricsResult

Résultat de la génération de statistiques historiques pour les 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 ce GenerateKeywordHistoryMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Historique des métriques pour le texte et ses variantes proches
text

string

Texte de la requête associée à un ou plusieurs mots clés. Notez que nous supprimons les doublons de votre liste de mots clés, é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 qui s'affiche contiendra uniquement "voitures". La liste des requêtes dédupliquées sera incluse dans le champ "closeVariants".