REST Resource: advertisers.adGroupAds

{
  "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.
}

string

Il nome della risorsa dell'annuncio.

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

Il nome visualizzato dell'annuncio.

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

enum (EntityStatus)

Lo stato dell'entità dell'annuncio.

object (AdUrl)

Elenco di URL utilizzati dall'annuncio.

object (DisplayVideoSourceAd)

Dettagli di un annuncio proveniente da un account Display & Creatività Video 360.

object (MastheadAd)

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

object (InStreamAd)

Dettagli di un annuncio in-stream ignorabile dopo 5 secondi, utilizzato per la brand awareness o il raggiungimento degli obiettivi di marketing.

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.

object (BumperAd)

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

object (AudioAd)

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

object (VideoDiscoveryAd)

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

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.

{
  "creativeId": string
}

string (int64 format)

L'ID della creatività di origine.

{
  "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)
    }
  ]
}

object (YoutubeVideoDetails)

Il video di YouTube utilizzato dall'annuncio.

string

Titolo dell'annuncio.

string

La descrizione dell'annuncio.

enum (VideoAspectRatio)

Le proporzioni del video di YouTube a riproduzione automatica sul masthead.

string (int64 format)

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

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".

string

Il testo del pulsante di invito all'azione.

string

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

string

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

boolean

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

object (YoutubeVideoDetails)

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

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

string

L'ID video di YouTube in cui è possibile eseguire ricerche sulla pagina web di YouTube.

enum (VideoUnavailableReason)

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

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

object (CommonInStreamAttribute)

Attributi degli annunci comuni.

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" }.

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

string

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

string

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

string

L'indirizzo URL caricato in background a scopo di monitoraggio.

string

Il testo del pulsante di invito all'azione.

string

Il titolo del banner di invito all'azione.

object (YoutubeVideoDetails)

Il video YouTube dell'annuncio.

object (ImageAsset)

L'immagine visualizzata accanto all'annuncio video.

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

string

Tipo MIME dell'asset immagine.

object (Dimensions)

I metadati per questa immagine nelle loro dimensioni originali.

string (int64 format)

Dimensioni del file dell'asset immagine in byte.

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

object (CommonInStreamAttribute)

Attributi degli annunci comuni.

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": {
    object (CommonInStreamAttribute)
  }
}

object (CommonInStreamAttribute)

Attributi degli annunci comuni.

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

string

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

string

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

string

L'indirizzo URL caricato in background a scopo di monitoraggio.

object (YoutubeVideoDetails)

Il video YouTube dell'annuncio.

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

string

Il titolo dell'annuncio.

string

Prima riga di testo dell'annuncio.

string

Seconda riga di testo dell'annuncio.

object (YoutubeVideoDetails)

Il video di YouTube promosso dall'annuncio.

enum (Thumbnail)

Immagine in miniatura utilizzata nell'annuncio.

{
  "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)
    }
  ]
}

string

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

string

L'indirizzo URL caricato in background a scopo di monitoraggio.

string

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

string

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

string

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

string

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

string

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

string

Il secondo elemento dopo il dominio nell'URL di visualizzazione.

string

Il dominio dell'URL di visualizzazione.

object (YoutubeVideoDetails)

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

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" }.

object (ImageAsset)

L'elenco dei banner companion utilizzati da questo annuncio.

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

enum (AdUrlType)

Il tipo di URL dell'annuncio.

string

Il valore della stringa dell'URL.