REST Resource: advertisers.adGroups

Risorsa: AdGroup

Un singolo gruppo di annunci associato a un elemento pubblicitario.

Rappresentazione JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa del gruppo di annunci.
advertiserId

string (int64 format)

Solo output. L'ID univoco dell'inserzionista a cui appartiene il gruppo di annunci.
adGroupId

string (int64 format)

Solo output. L'ID univoco del gruppo di annunci. Assegnato dal sistema.
lineItemId

string (int64 format)

Obbligatorio. Immutabile. L'ID univoco dell'elemento pubblicitario a cui appartiene il gruppo di annunci.
displayName

string

Obbligatorio. Il nome visualizzato del gruppo di annunci.

Deve essere codificato in UTF-8 con una dimensione massima di 255 byte.
adGroupFormat

enum (AdGroupFormat)

Obbligatorio. Immutabile. Il formato degli annunci nel gruppo di annunci.
bidStrategy

object (BiddingStrategy)

Facoltativo. La strategia di offerta utilizzata dal gruppo di annunci. Nella strategia di offerta è possibile utilizzare solo i campi youtubeAndPartnersBid e demandGenBid.
entityStatus

enum (EntityStatus)

Obbligatorio. Controlla se il gruppo di annunci può spendere il proprio budget e fare offerte per l'inventario.

Se l'elemento pubblicitario principale del gruppo di annunci non è attivo, il gruppo di annunci non può spendere il proprio budget anche se il suo stato è ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

Facoltativo. Le impostazioni di targeting ottimizzato del gruppo di annunci.
productFeedData

object (ProductFeedData)

Facoltativo. Le impostazioni del feed dei prodotti in questo gruppo di annunci.
adGroupInventoryControl

object (AdGroupInventoryControl)

Facoltativo. Obbligatorio per i gruppi di annunci Demand Gen. Specifica il controllo dell'inventario del gruppo di annunci.
adSource

enum (AdSource)

Facoltativo. L'origine degli annunci in questo gruppo di annunci. Questo campo viene utilizzato solo quando gli annunci vengono generati automaticamente da una determinata origine.
creativeAssignments[]

object (CreativeAssignment)

Facoltativo. Le creatività utilizzate per generare annunci nel gruppo di annunci.

Questo campo può essere assegnato solo se adSource è AD_SOURCE_DV360_CREATIVE.

AdGroupFormat

Il formato del gruppo di annunci.

Enum
AD_GROUP_FORMAT_UNSPECIFIED Il valore del formato non è specificato o è sconosciuto in questa versione.
AD_GROUP_FORMAT_IN_STREAM Annunci in-stream.
AD_GROUP_FORMAT_VIDEO_DISCOVERY Annunci in-feed.
AD_GROUP_FORMAT_BUMPER Annunci bumper.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Annunci in-stream non ignorabili.
AD_GROUP_FORMAT_AUDIO Annunci audio in-stream non ignorabili.
AD_GROUP_FORMAT_RESPONSIVE Annunci adattabili.
AD_GROUP_FORMAT_REACH Gruppi di annunci Copertura efficace, inclusi gli annunci in-stream e bumper.
AD_GROUP_FORMAT_MASTHEAD Annuncio masthead visualizzato nello spazio superiore della home page di YouTube.
AD_GROUP_FORMAT_DEMAND_GEN Annunci Demand Gen.

ProductFeedData

I dettagli del feed dei prodotti.

Rappresentazione JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Campi
productMatchType

enum (ProductMatchType)

Come vengono selezionati i prodotti dal feed dei prodotti.
productMatchDimensions[]

object (ProductMatchDimension)

Un elenco di dimensioni utilizzate per trovare i prodotti corrispondenti.
isFeedDisabled

boolean

Se il feed dei prodotti ha disattivato la visualizzazione dei prodotti.

ProductMatchType

I tipi di modi per abbinare i prodotti.

Enum
PRODUCT_MATCH_TYPE_UNSPECIFIED Non specificato o sconosciuto.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Tutti i prodotti sono abbinati.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Sono selezionati prodotti specifici.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Abbina i prodotti in base alle loro etichette personalizzate.

ProductMatchDimension

Una dimensione utilizzata per trovare i prodotti corrispondenti.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
Campi
La dimensione e il valore in base ai quali trovare la corrispondenza con il prodotto. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
productOfferId

string

L'ID dell'offerta di prodotto da abbinare a un prodotto con lo stesso ID offerta.
customLabel

object (CustomLabel)

L'etichetta personalizzata per trovare tutti i prodotti con l'etichetta.
Fine dei campi che si escludono a vicenda.

CustomLabel

La chiave e il valore di un'etichetta personalizzata.

Rappresentazione JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Campi
key

enum (CustomLabelKey)

La chiave dell'etichetta.
value

string

Il valore dell'etichetta.

CustomLabelKey

La chiave dell'etichetta personalizzata

Enum
CUSTOM_LABEL_KEY_UNSPECIFIED Non specificato o sconosciuto.
CUSTOM_LABEL_KEY_0 Indice chiave 0.
CUSTOM_LABEL_KEY_1 Indice chiave 1.
CUSTOM_LABEL_KEY_2 Indice chiave 2.
CUSTOM_LABEL_KEY_3 Indice chiave 3.
CUSTOM_LABEL_KEY_4 Indice chiave 4.

AdGroupInventoryControl

Il controllo dell'inventario del gruppo di annunci.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
Campi
Il controllo dell'inventario del gruppo di annunci. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

La strategia di inventario.
selectedInventories

object (SelectedInventories)

Gli inventari selezionati.
Fine dei campi che si escludono a vicenda.

AdGroupInventoryStrategy

La strategia di inventario per il gruppo di annunci.

Enum
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Non specificato o sconosciuto.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY Il gruppo di annunci è attivato per tutto l'inventario di Google e della Rete Display.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY Il gruppo di annunci è attivato per tutto l'inventario Google.

SelectedInventories

Il controllo dell'inventario del gruppo di annunci.

Rappresentazione JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Campi
allowYoutubeStream

boolean

Indica se il gruppo di annunci ha attivato l'inventario in-stream di YouTube.
allowYoutubeShorts

boolean

Indica se il gruppo di annunci ha attivato l'inventario di YouTube Shorts.
allowYoutubeFeed

boolean

Indica se il gruppo di annunci ha attivato l'inventario degli annunci in-feed di YouTube.
allowDiscover

boolean

Indica se il gruppo di annunci ha attivato l'inventario Discover.
allowGmail

boolean

Indica se il gruppo di annunci ha attivato l'inventario Gmail.
allowGoogleDisplayNetwork

boolean

Indica se il gruppo di annunci è attivato per l'inventario della Rete Display di Google.

AdSource

Origine degli annunci in questo gruppo di annunci.

Enum
AD_SOURCE_UNSPECIFIED Non specificato o sconosciuto. Il valore predefinito è l'origine annuncio standard.
AD_SOURCE_DV360_CREATIVE Proveniente da una creatività DV360.

CreativeAssignment

I dettagli di un'assegnazione creatività al gruppo di annunci.

Rappresentazione JSON 
{
  "creativeId": string
}
Campi
creativeId

string (int64 format)

Obbligatorio. L'ID della creatività Display & Video 360 assegnata al gruppo di annunci.

Metodi

bulkEditAssignedTargetingOptions

 Modifica collettivamente le opzioni di targeting per più gruppi di annunci.

bulkListAssignedTargetingOptions

 Elenca le opzioni di targeting assegnate per più gruppi di annunci in tutti i tipi di targeting.

create

 Crea un nuovo gruppo di annunci.

delete

 Elimina un gruppo di annunci.

get

 Recupera un gruppo di annunci.

list

 Elenca i gruppi di annunci.

patch

 Aggiorna un gruppo di annunci esistente.