Method: customers.generateAdGroupThemes

Restituisce un elenco di gruppi di annunci suggeriti e di modifiche suggerite (testo, tipo di corrispondenza) per le parole chiave specificate.

Elenco degli errori generati: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "keywords": [
    string
  ],
  "adGroups": [
    string
  ]
}
Campi
keywords[]

string

Obbligatorio. Un elenco di parole chiave da raggruppare nei gruppi di annunci forniti.
adGroups[]

string

Obbligatorio. Un elenco di nomi di risorse dei gruppi di annunci in cui raggruppare le parole chiave. Formato del nome della risorsa: customers/{customerId}/adGroups/{adGroupId}

Corpo della risposta

Messaggio di risposta per KeywordPlanIdeaService.GenerateAdGroupThemes.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
Campi
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

Un elenco di combinazioni suggerite di gruppi di annunci e parole chiave.
unusableAdGroups[]

object (UnusableAdGroup)

Un elenco dei gruppi di annunci forniti che non è stato possibile utilizzare come suggerimenti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/adwords

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

AdGroupKeywordSuggestion

Il testo suggerito e l'abbinamento Gruppo di annunci/Campagna per una determinata parola chiave.

Rappresentazione JSON 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
Campi
keywordText

string

Il testo della parola chiave originale.
suggestedKeywordText

string

La versione normalizzata di KeywordText per suggerimenti GENERICA/ESATTA/A FRASE.
suggestedMatchType

enum (KeywordMatchType)

Il tipo di corrispondenza delle parole chiave suggerito.
suggestedAdGroup

string

Il gruppo di annunci suggerito per la parola chiave. Formato del nome della risorsa: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

La campagna suggerita per la parola chiave. Formato del nome della risorsa: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

Una coppia gruppo di annunci/campagna che non può essere utilizzata come suggerimento per le parole chiave.

I gruppi di annunci potrebbero non essere utilizzabili se

  • appartiene a una campagna che non è ABILITATA o IN PAUSA
  • non è ABILITATO
Rappresentazione JSON 
{
  "adGroup": string,
  "campaign": string
}
Campi
adGroup

string

Il nome della risorsa Gruppo di annunci. Formato del nome della risorsa: customers/{customerId}/adGroups/{adGroupId}
campaign

string

Il nome della risorsa della campagna. Formato del nome della risorsa: customers/{customerId}/campaigns/{campaignId}