REST Resource: advertisers.youtubeAdGroupAds

Risorsa: YouTubeAdGroupAd

Un singolo annuncio associato a un gruppo di annunci di YouTube.

Rappresentazione JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
Campi
name

string

Il nome della risorsa dell'annuncio.
advertiserId

string (int64 format)

L'ID univoco dell'inserzionista a cui appartiene l'annuncio.
adGroupAdId

string (int64 format)

L'ID univoco dell'annuncio. Assegnato dal sistema.
adGroupId

string (int64 format)

L'ID univoco del gruppo di annunci a cui appartiene l'annuncio.
displayName

string

Il nome visualizzato dell'annuncio.

Deve essere codificata in UTF-8 con una dimensione massima di 255 byte.
entityStatus

enum (EntityStatus)

Lo stato dell'entità dell'annuncio.
adUrls[]

object (AdUrl)

Elenco di URL utilizzati dall'annuncio.
Campo di unione ad_details. I dettagli dell'annuncio. ad_details può essere solo uno dei seguenti:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Dettagli di un annuncio proveniente da una creatività Display & Video 360.
mastheadAd

object (MastheadAd)

Dettagli di un annuncio pubblicato nel feed della home page di YouTube.
inStreamAd

object (InStreamAd)

Dettagli di un annuncio in-stream ignorabile dopo 5 secondi, utilizzato per la notorietà del brand o per raggiungere gli obiettivi di marketing.
nonSkippableAd

object (NonSkippableAd)

Dettagli di un annuncio video in-stream breve non ignorabile, di durata compresa tra 6 e 15 secondi, utilizzato per raggiungere gli obiettivi di marketing.
bumperAd

object (BumperAd)

Dettagli di un annuncio video breve non ignorabile, di durata uguale o inferiore a 6 secondi, utilizzato per la copertura.
audioAd

object (AudioAd)

Dettagli di un annuncio audio utilizzato per raggiungere gli obiettivi di marketing.
videoDiscoverAd

object (VideoDiscoveryAd)

Dettagli di un annuncio che promuove un video mostrato in luoghi di scoperta.
videoPerformanceAd

object (VideoPerformanceAd)

Dettagli di un annuncio utilizzato in una campagna video per azione per incentivare le azioni verso l'attività, il servizio o il prodotto.

DisplayVideoSourceAd

L'annuncio proveniente da una creatività DV360.

Rappresentazione JSON 
{
  "creativeId": string
}
Campi
creativeId

string (int64 format)

L'ID della creatività di origine.

MastheadAd

Dettagli per un annuncio masthead.

Rappresentazione JSON 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Campi
video

object (YoutubeVideoDetails)

Il video di YouTube utilizzato dall'annuncio.
headline

string

Titolo dell'annuncio.
description

string

La descrizione dell'annuncio.
videoAspectRatio

enum (VideoAspectRatio)

Le proporzioni del video di YouTube con riproduzione automatica sul masthead.
autoplayVideoStartMillisecond

string (int64 format)

La quantità di tempo in millisecondi trascorsa dal quale viene avviata la riproduzione del video.
autoplayVideoDuration

string (Duration format)

Il periodo di tempo in cui il video viene riprodotto automaticamente.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
callToActionButtonLabel

string

Il testo sul pulsante di invito all'azione.
callToActionFinalUrl

string

L'URL di destinazione del pulsante di invito all'azione.
callToActionTrackingUrl

string

L'URL di monitoraggio per il pulsante di invito all'azione.
showChannelArt

boolean

Da indicare se mostrare uno sfondo o un banner nella parte superiore di una pagina di YouTube.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

I video che vengono visualizzati accanto all'annuncio masthead su computer. Non può essere superiore a due.

YoutubeVideoDetails

Dettagli di un video di YouTube.

Rappresentazione JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
Campi
id

string

L'ID video di YouTube che è possibile cercare sulla pagina web di YouTube.
unavailableReason

enum (VideoUnavailableReason)

Il motivo per cui i dati del video non sono disponibili.

VideoUnavailableReason

Possibili motivi per cui un video potrebbe non essere disponibile.

Enum
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Sconosciuto o non specificato.
VIDEO_UNAVAILABLE_REASON_PRIVATE Il video è privato.
VIDEO_UNAVAILABLE_REASON_DELETED Il video è stato eliminato.

VideoAspectRatio

Possibili proporzioni per un video di YouTube.

Enum
VIDEO_ASPECT_RATIO_UNSPECIFIED Non specificato o sconosciuto.
VIDEO_ASPECT_RATIO_WIDESCREEN Il video è allungato e le parti superiore e inferiore vengono ritagliate.
VIDEO_ASPECT_RATIO_FIXED_16_9 Il video utilizza proporzioni fisse 16:9.

InStreamAd

Dettagli per un annuncio in-stream.

Rappresentazione JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Campi
commonInStreamAttribute

object (CommonInStreamAttribute)

Attributi comuni degli annunci.
customParameters

map (key: string, value: string)

I parametri personalizzati per trasmettere valori personalizzati al modello di URL di monitoraggio.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

Attributi comuni per gli annunci in-stream, non ignorabili e bumper.

Rappresentazione JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Campi
displayUrl

string

L'indirizzo della pagina web visualizzato con l'annuncio.
finalUrl

string

L'indirizzo URL della pagina web che gli utenti raggiungono dopo aver fatto clic sull'annuncio.
trackingUrl

string

L'indirizzo URL caricato in background ai fini del monitoraggio.
actionButtonLabel

string

Il testo sul pulsante di invito all'azione.
actionHeadline

string

Il titolo del banner di invito all'azione.
video

object (YoutubeVideoDetails)

Il video di YouTube dell'annuncio.
companionBanner

object (ImageAsset)

L'immagine che viene visualizzata accanto all'annuncio video.

ImageAsset

Metadati di un asset immagine.

Rappresentazione JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
Campi
mimeType

string

Tipo MIME dell'asset immagine.
fullSize

object (Dimensions)

I metadati di questa immagine nelle dimensioni originali.
fileSize

string (int64 format)

Dimensioni del file dell'asset immagine in byte.

NonSkippableAd

Dettagli per un annuncio non ignorabile.

Rappresentazione JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Campi
commonInStreamAttribute

object (CommonInStreamAttribute)

Attributi comuni degli annunci.
customParameters

map (key: string, value: string)

I parametri personalizzati per trasmettere valori personalizzati al modello di URL di monitoraggio.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

Dettagli per un annuncio bumper.

Rappresentazione JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Campi
commonInStreamAttribute

object (CommonInStreamAttribute)

Attributi comuni degli annunci.

AudioAd

Dettagli per un annuncio audio.

Rappresentazione JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Campi
displayUrl

string

L'indirizzo della pagina web visualizzato con l'annuncio.
finalUrl

string

L'indirizzo URL della pagina web che gli utenti raggiungono dopo aver fatto clic sull'annuncio.
trackingUrl

string

L'indirizzo URL caricato in background ai fini del monitoraggio.
video

object (YoutubeVideoDetails)

Il video di YouTube dell'annuncio.

VideoDiscoveryAd

Dettagli per un annuncio video discovery.

Rappresentazione JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
Campi
headline

string

Il titolo dell'annuncio.
description1

string

Prima riga di testo dell'annuncio.
description2

string

Seconda riga di testo per l'annuncio.
video

object (YoutubeVideoDetails)

Il video di YouTube promosso dall'annuncio.
thumbnail

enum (Thumbnail)

Immagine in miniatura utilizzata nell'annuncio.

Miniatura

Possibili opzioni per le miniature negli annunci video discovery.

Enum
THUMBNAIL_UNSPECIFIED Sconosciuto o non specificato.
THUMBNAIL_DEFAULT La miniatura predefinita può essere generata automaticamente o caricata dall'utente.
THUMBNAIL_1 Miniatura 1, generata dal video.
THUMBNAIL_2 Miniatura 2, generata dal video.
THUMBNAIL_3 Miniatura 3, generata dal video.

VideoPerformanceAd

Dettagli di un annuncio di rendimento video.

Rappresentazione JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
Campi
finalUrl

string

L'indirizzo URL della pagina web che gli utenti raggiungono dopo aver fatto clic sull'annuncio.
trackingUrl

string

L'indirizzo URL caricato in background ai fini del monitoraggio.
actionButtonLabels[]

string

L'elenco di asset di testo visualizzati sul pulsante di invito all'azione.
headlines[]

string

L'elenco dei titoli mostrati nel banner di invito all'azione.
longHeadlines[]

string

L'elenco dei singoli titoli mostrato nel banner di invito all'azione.
descriptions[]

string

L'elenco di descrizioni mostrato nel banner di invito all'azione.
displayUrlBreadcrumb1

string

La prima parte dopo il dominio nell'URL di visualizzazione.
displayUrlBreadcrumb2

string

La seconda parte dopo il dominio dell'URL di visualizzazione.
domain

string

Il dominio dell'URL di visualizzazione.
videos[]

object (YoutubeVideoDetails)

L'elenco degli asset video di YouTube utilizzati da questo annuncio.
customParameters

map (key: string, value: string)

I parametri personalizzati per trasmettere valori personalizzati al modello di URL di monitoraggio.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanners[]

object (ImageAsset)

L'elenco dei banner companion utilizzati dall'annuncio.

AdUrl

URL aggiuntivi correlati all'annuncio, inclusi i beacon.

Rappresentazione JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
Campi
type

enum (AdUrlType)

Il tipo di URL dell'annuncio.
url

string

Il valore della stringa dell'URL.

AdUrlType

Possibili tipi di URL dell'annuncio.

Enum
AD_URL_TYPE_UNSPECIFIED Sconosciuto o non specificato.
AD_URL_TYPE_BEACON_IMPRESSION Un pixel di monitoraggio 1 x 1 da inviare quando viene pubblicata un'impressione di una creatività.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Beaconing delle impressioni DCM espandibile. Al momento della pubblicazione, si espande in diversi beacon.
AD_URL_TYPE_BEACON_CLICK URL di monitoraggio per il ping quando viene attivato l'evento di clic.
AD_URL_TYPE_BEACON_SKIP URL di monitoraggio per il ping quando viene attivato l'evento Ignora.

Metodi

get

 Recupera un annuncio di un gruppo di annunci di YouTube.

list

 Elenca gli annunci dei gruppi di annunci di YouTube.