Method: customers.generateAdGroupThemes

Affiche une liste de groupes d'annonces et de modifications suggérés (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 AdGroups fournis.
adGroups[]

string

Obligatoire. Liste des 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)

Liste de suggestions de paires de mots clés/groupes d'annonces.
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 requête large/EXACT/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.

Les groupes d'annonces peuvent ne pas être utilisables si :

  • appartient à une campagne qui n'est pas ACTIVÉE ou MISE EN VEIILLE
  • 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 la ressource Campaign. Format du nom de la ressource : customers/{customerId}/campaigns/{campaignId}