REST Resource: advertisers.youtubeAdGroupAds

Risorsa: annunciogruppodiannunciYouTube

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 unione ad_details. I dettagli dell'annuncio. ad_details può essere solo uno dei seguenti:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Dettagli di un annuncio proveniente da un account Display & Creatività 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 brand awareness o il raggiungimento degli 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 azioni nei confronti dell'attività, del servizio o del prodotto.

DisplayVideoSourceAd

L'annuncio proviene da una creatività DV360.

Rappresentazione JSON
{
  "creativeId": string
}
Campi
creativeId

string (int64 format)

L'ID della creatività di origine.

MastheadAd

Dettagli relativi a 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 a riproduzione automatica sul masthead.

autoplayVideoStartMillisecond

string (int64 format)

La quantità di tempo in millisecondi dopo la quale inizierà la riproduzione del video.

autoplayVideoDuration

string (Duration format)

La durata della riproduzione automatica del video.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

callToActionButtonLabel

string

Il testo del pulsante di invito all'azione.

callToActionFinalUrl

string

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

callToActionTrackingUrl

string

L'URL di monitoraggio del pulsante di invito all'azione.

showChannelArt

boolean

Se mostrare uno sfondo o un banner nella parte superiore di una pagina YouTube.

companionYoutubeVideos[]

object (YoutubeVideoDetails)

I video che vengono visualizzati accanto all'annuncio masthead su computer. Non può essere più di due.

YoutubeVideoDetails

Dettagli di un video di YouTube.

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

string

L'ID video di YouTube in cui è possibile eseguire ricerche 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 sono ritagliate.
VIDEO_ASPECT_RATIO_FIXED_16_9 Il video utilizza proporzioni fisse 16:9.

InStreamAd

Dettagli relativi a un annuncio in-stream.

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

object (CommonInStreamAttribute)

Attributi degli annunci comuni.

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 a scopo di monitoraggio.

actionButtonLabel

string

Il testo del pulsante di invito all'azione.

actionHeadline

string

Il titolo del banner di invito all'azione.

video

object (YoutubeVideoDetails)

Il video YouTube dell'annuncio.

companionBanner

object (ImageAsset)

L'immagine 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 per questa immagine nelle loro dimensioni originali.

fileSize

string (int64 format)

Dimensioni del file dell'asset immagine in byte.

NonSkippableAd

Dettagli relativi a un annuncio non ignorabile.

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

object (CommonInStreamAttribute)

Attributi degli annunci comuni.

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 degli annunci comuni.

AudioAd

Dettagli di 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 a scopo di monitoraggio.

video

object (YoutubeVideoDetails)

Il video YouTube dell'annuncio.

VideoDiscoveryAd

Dettagli relativi a 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 dell'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 a partire dal video.
THUMBNAIL_2 Miniatura 2, generata a partire dal video.
THUMBNAIL_3 Miniatura 3, generata a partire dal video.

VideoPerformanceAd

Dettagli relativi a un annuncio video basato sul rendimento.

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 a scopo di monitoraggio.

actionButtonLabels[]

string

L'elenco di asset di testo visualizzati nel pulsante di invito all'azione.

headlines[]

string

L'elenco di titoli visualizzati nel banner di invito all'azione.

longHeadlines[]

string

L'elenco di titoli solitari mostrati nel banner di invito all'azione.

descriptions[]

string

L'elenco di descrizioni visualizzate nel banner di invito all'azione.

displayUrlBreadcrumb1

string

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

displayUrlBreadcrumb2

string

Il secondo elemento dopo il dominio nell'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 da questo 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 di cui eseguire il ping quando viene pubblicata un'impressione di una creatività.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Beaconing delle impressioni DCM espandibile. Al momento della pubblicazione, viene estesa a 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 Salta.

Metodi

get

Visualizza un annuncio del gruppo di annunci di YouTube.

list

Elenca gli annunci del gruppo di annunci di YouTube.