Method: customers.generateKeywordHistoricalMetrics

Affiche une liste de métriques historiques pour le mot clé.

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

Requête HTTP

POST https://googleads.googleapis.com/v15/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

Une liste de mots clés pour obtenir l'historique des métriques. En raison de la déduplication quasi exacte, toutes les entrées ne seront pas renvoyé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 relatifs au contenu réservé aux adultes seront inclus dans la réponse. La valeur par défaut est "false".
geoTargetConstants[]

string

Noms de ressources de l'emplacement à 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, la recherche Google et le réseau des partenaires sont utilisés.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Champs d'agrégation à inclure dans la réponse.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Options pour les données de l'historique des métriques.
language

string

Nom de ressource de la langue à cibler. Chaque mot clé correspond à une langue spécifique. Un mot clé est inclus si la langue fait partie de ses langues. Si cette règle n'est pas configurée, tous les mots clés seront 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)

Statistiques cumulé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 des métriques d'historique 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 ce GenerateKeywordHistoryMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Historique des métriques 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 dans 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 demande contenait à l'origine les mots clés "voiture" et "voitures", la requête de recherche ne contiendra que "voitures". La liste des requêtes dédupliquées sera incluse dans le champ "closeVariants".