Method: customers.generateAdGroupThemes

Restituisce un elenco di gruppi di annunci suggeriti e 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/v16/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 gruppo di annunci/parola chiave.
unusableAdGroups[]

object (UnusableAdGroup)

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

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'accoppiamento 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 originale della parola chiave.
suggestedKeywordText

string

La versione normalizzata di keywordText per i suggerimenti generici/esatti/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 il gruppo

  • Appartiene a una campagna che non è ATTIVA o IN PAUSA
  • non è ABILITATO di per sé
Rappresentazione JSON 
{
  "adGroup": string,
  "campaign": string
}
Campi
adGroup

string

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

string

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