- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- GenerateKeywordHistoricalMetricsResult
- Essayer
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 |
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 ( |
Champs | |
---|---|
keywords[] |
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 |
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[] |
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 |
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 |
Champs agrégés à inclure dans la réponse. |
historicalMetricsOptions |
Options pour les données de métriques historiques. |
language |
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 ( |
Champs | |
---|---|
results[] |
Liste de mots clés et historique des métriques associées |
aggregateMetricResults |
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 ( |
Champs | |
---|---|
closeVariants[] |
Liste des variantes proches des mots clés demandés dont les statistiques sont combinées dans ce GenerateKeywordHistoryMetricsResult. |
keywordMetrics |
Historique des métriques pour le texte et ses variantes proches |
text |
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". |