Method: customers.generateAdGroupThemes

Affiche une liste de suggestions de groupes d'annonces et de modifications (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/v16/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. Liste de mots clés à regrouper dans les groupes d'annonces fournis.
adGroups[]

string

Obligatoire. Liste de noms de ressources des groupes d'annonces dans lesquels regrouper les mots clés. Format du nom de 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)

Liste de suggestions de combinaisons 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 de type 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 ressource: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

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

UnusableAdGroup

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

Les groupes d'annonces risquent de ne pas être utilisables s'ils ne sont pas

  • appartient à une campagne qui n'est ni ACTIVÉE, ni mise en veille.
  • lui-même n'est pas ACTIVÉ
Représentation JSON 
{
  "adGroup": string,
  "campaign": string
}
Champs
adGroup

string

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

string

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