Method: customers.generateAdGroupThemes

Affiche une liste de groupes d'annonces et de modifications suggérées (texte, type de correspondance) pour les mots clés donnés.

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

Requête HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateAdGroupThemes

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client.

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
  ],
  "adGroups": [
    string
  ]
}
Champs
keywords[]

string

Obligatoire. Une liste de mots clés à regrouper dans les groupes d'annonces fournis.
adGroups[]

string

Obligatoire. Une liste de noms de ressources des groupes d'annonces dans lesquels regrouper les mots clés. Format du nom de la ressource: customers/{customerId}/adGroups/{adGroupId}

Corps de la réponse

Message de réponse pour KeywordPlanIdeaService.GenerateAdGroupThemes.

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

Représentation JSON 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
Champs
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

Une liste de suggestions d'associations groupe d'annonces/mot clé
unusableAdGroups[]

object (UnusableAdGroup)

Liste des groupes d'annonces fournis qui n'ont pas pu être utilisés comme suggestions.

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.

AdGroupKeywordSuggestion

Texte suggéré et association groupe d'annonces/campagne pour un mot clé donné.

Représentation JSON 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
Champs
keywordText

string

Texte du mot clé d'origine.
suggestedKeywordText

string

Version normalisée de keywordText pour les suggestions LARGE/EXACTE/PHRASE.
suggestedMatchType

enum (KeywordMatchType)

Type de correspondance des mots clés suggéré.
suggestedAdGroup

string

Groupe d'annonces suggéré pour le mot clé. Format du nom de la ressource: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

Campagne suggérée pour le mot clé. Format du nom de la ressource: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

Paire groupe d'annonces/campagne qui n'a pas pu être utilisée comme suggestion pour les mots clés.

Il est possible que les groupes d'annonces ne soient pas utilisables

  • appartient à une campagne dont le statut n'est pas ACTIVÉ ou mis en veille.
  • n'est pas ACTIVÉ
Représentation JSON 
{
  "adGroup": string,
  "campaign": string
}
Champs
adGroup

string

Nom de ressource du groupe d'annonces. Format du nom de la ressource: customers/{customerId}/adGroups/{adGroupId}
campaign

string

Nom de ressource de la campagne. Format du nom de la ressource: customers/{customerId}/campaigns/{campaignId}