REST Resource: advertisers.youtubeAdGroups

Risorsa: gruppo di annunci di YouTube

Un singolo gruppo di annunci di YouTube associato a un elemento pubblicitario YouTube e partner.

Rappresentazione JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Campi
name

string

Il nome della risorsa del gruppo di annunci.
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

Il nome visualizzato del gruppo di annunci.

Deve essere codificato in UTF-8 con una dimensione massima di 255 byte.
youtubeAdIds[]

string (int64 format)

Gli ID delle risorse [youtube_ad_group_ad][] associate al gruppo di annunci.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

Il formato degli annunci nel gruppo di annunci.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

La strategia di offerta utilizzata dal gruppo di annunci.
entityStatus

enum (EntityStatus)

Controlla se il gruppo di annunci può spendere il 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 relativo stato è ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

Le impostazioni di espansione del targeting del gruppo di annunci.

Questa configurazione è applicabile solo quando al gruppo di annunci viene assegnato il targeting per elenco del segmento di pubblico idoneo.
productFeedData

object (ProductFeedData)

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

YoutubeAndPartnersAdGroupFormat

Il formato del gruppo di annunci di YouTube.

Enum
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED Il valore del formato non è specificato o è sconosciuto in questa versione.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Annunci in-stream.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Annunci in-feed.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Annunci bumper.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Annunci in-stream non ignorabili.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Annunci audio in-stream non ignorabili.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Annunci adattabili per le campagne video per azione.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Gruppi di annunci con copertura efficace, inclusi gli annunci in-stream e bumper.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Annuncio masthead visualizzato nello spazio in alto della home page di YouTube.

ProductFeedData

I dettagli del feed dei prodotti.

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

enum (ProductMatchType)

La modalità di selezione dei prodotti dal feed dei prodotti.
productMatchDimensions[]

object (ProductMatchDimension)

Un elenco di dimensioni utilizzate per abbinare i prodotti.
isFeedDisabled

boolean

Indica se la visualizzazione dei prodotti nel feed dei prodotti è stata disattivata.

ProductMatchType

I tipi di modalità di corrispondenza dei 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 Associa i prodotti in base alle loro etichette personalizzate.

ProductMatchDimension

Una dimensione utilizzata per associare i prodotti.

Rappresentazione JSON 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Campi
Campo unione dimension. La dimensione e il valore in base ai quali trovare una corrispondenza per il prodotto. dimension può essere solo uno dei seguenti:
productOfferId

string

L'ID dell'offerta del prodotto da associare a un prodotto con lo stesso ID offerta.
customLabel

object (CustomLabel)

L'etichetta personalizzata da associare a tutti i prodotti con l'etichetta.

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.

Metodi

bulkListAdGroupAssignedTargetingOptions

 Elenca le opzioni di targeting assegnate per più gruppi di annunci di YouTube nei vari tipi di targeting.

get

 Recupera un gruppo di annunci di YouTube.

list

 Elenca i gruppi di annunci di YouTube.