REST Resource: advertisers.adGroupAds

Risorsa: AdGroupAd

Un singolo annuncio associato a un gruppo di annunci.

Rappresentazione JSON
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
Campi
name

string

Solo output. Il nome della risorsa dell'annuncio.

advertiserId

string (int64 format)

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

adGroupAdId

string (int64 format)

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

adGroupId

string (int64 format)

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

displayName

string

Obbligatorio. Il nome visualizzato dell'annuncio.

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

adPolicy

object (AdPolicy)

Solo output. Lo stato di approvazione delle norme dell'annuncio.

entityStatus

enum (EntityStatus)

Obbligatorio. Lo stato dell'entità dell'annuncio.

adUrls[]

object (AdUrl)

Solo output. Elenco di URL utilizzati dall'annuncio.

dcmTrackingInfo

object (DcmTrackingInfo)

Facoltativo. Le informazioni sull'annuncio di monitoraggio DCM.

Per rimuovere le informazioni sull'annuncio di monitoraggio DCM, lascia vuoto questo campo.

containsSyntheticMedia

boolean

Facoltativo. Indica se l'annuncio contiene contenuti multimediali alterati o sintetici.

Deve essere impostato solo per gli annunci realizzati da inserzionisti elettorali verificati. Valido solo per gli annunci di YouTube.

parentCreativeId

string (int64 format)

Solo output. L'ID della creatività Display & Video 360 utilizzata per generare questo annuncio.

Questo campo verrà compilato solo per gli annunci generati da creatività assegnate al gruppo di annunci principale.

I dettagli dell'annuncio. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
displayVideoSourceAd

object (DisplayVideoSourceAd)

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

mastheadAd

object (MastheadAd)

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

inStreamAd

object (InStreamAd)

Solo output. Dettagli di un annuncio in-stream ignorabile dopo 5 secondi, utilizzato per obiettivi di marketing di brand awareness o copertura.

nonSkippableAd

object (NonSkippableAd)

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

bumperAd

object (BumperAd)

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

audioAd

object (AudioAd)

Solo output. Dettagli di un annuncio audio utilizzato per gli obiettivi di marketing di copertura.

videoDiscoverAd

object (VideoDiscoveryAd)

Solo output. Dettagli di un annuncio che promuove un video visualizzato in luoghi di scoperta.

videoPerformanceAd

object (VideoPerformanceAd)

Solo output. Dettagli di un annuncio utilizzato in una campagna video per azione per incentivare l'azione nei confronti dell'attività, del servizio o del prodotto.

demandGenVideoAd

object (DemandGenVideoAd)

Facoltativo. Dettagli di un annuncio video Demand Gen.

demandGenImageAd

object (DemandGenImageAd)

Facoltativo. Dettagli di un annuncio illustrato Demand Gen.

demandGenProductAd

object (DemandGenProductAd)

Facoltativo. Dettagli di un annuncio di prodotto Demand Gen.

Fine dei campi che si escludono a vicenda.

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 di 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 nel masthead.

autoplayVideoStartMillisecond

string (int64 format)

Il tempo in millisecondi dopo il quale inizierà la riproduzione del video.

autoplayVideoDuration

string (Duration format)

La durata della riproduzione automatica del video.

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

callToActionButtonLabel

string

Il testo del pulsante call to action.

callToActionFinalUrl

string

L'URL di destinazione del pulsante call to action.

callToActionTrackingUrl

string

L'URL di monitoraggio del pulsante call to action.

showChannelArt

boolean

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

companionYoutubeVideos[]

object (YoutubeVideoDetails)

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

YoutubeVideoDetails

Dettagli di un video di YouTube.

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

string

Solo output. L'ID video di YouTube che può essere cercato sulla pagina web di YouTube.

unavailableReason

enum (VideoUnavailableReason)

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

videoAssetId

string (int64 format)

Obbligatorio. L'ID asset video di YouTube. Questo è il adAssetId di una risorsa AdAsset.

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 viene eliminato.

VideoAspectRatio

Possibili proporzioni per un video di YouTube.

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

InStreamAd

I dettagli di un annuncio in-stream.

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

object (CommonInStreamAttribute)

Obbligatorio. Attributi degli annunci comuni.

customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori associati da aggiungere all'URL di monitoraggio.

Un oggetto contenente un elenco di coppie "key": value. 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,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Campi
displayUrl

string

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

finalUrl

string

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

trackingUrl

string

Solo output. L'indirizzo URL caricato in background per il monitoraggio.

Nella versione 4 e precedenti, questo campo rappresenta l'URL di monitoraggio specificato manualmente dall'utente. Puoi trovarlo in userSpecifiedTrackingUrl nella versione 5.

userSpecifiedTrackingUrl

string

Facoltativo. L'URL di monitoraggio specificato manualmente dall'utente.

actionButtonLabel

string

Facoltativo. Il testo del pulsante call to action.

Deve essere impostato se è impostato actionHeadline.

actionHeadline

string

Facoltativo. Il titolo del banner di invito all'azione.

video

object (YoutubeVideoDetails)

Obbligatorio. Immutabile. Il video di YouTube dell'annuncio.

companionBanner

object (ImageAsset)

Facoltativo. L'immagine visualizzata accanto all'annuncio video.

ImageAsset

Metadati di un asset immagine.

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

string

Solo output. Tipo MIME dell'asset immagine.

fullSize

object (Dimensions)

Solo output. Metadati per questa immagine nelle dimensioni originali.

fileSize

string (int64 format)

Solo output. Dimensioni del file dell'asset immagine in byte.

assetId

string (int64 format)

Obbligatorio. L'ID univoco dell'asset.

NonSkippableAd

I dettagli di un annuncio non ignorabile.

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

object (CommonInStreamAttribute)

Obbligatorio. Attributi degli annunci comuni.

customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori associati da aggiungere all'URL di monitoraggio.

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

BumperAd

Dettagli di un annuncio bumper.

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

object (CommonInStreamAttribute)

Obbligatorio. Attributi degli annunci comuni.

AudioAd

Dettagli di un annuncio audio.

Rappresentazione JSON
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": 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 per il monitoraggio.

Nella versione 4 e precedenti, questo campo rappresenta l'URL di monitoraggio specificato manualmente dall'utente. Puoi trovarlo in userSpecifiedTrackingUrl nella versione 5.

userSpecifiedTrackingUrl

string

Facoltativo. L'URL di monitoraggio specificato manualmente dall'utente.

video

object (YoutubeVideoDetails)

Il video di YouTube dell'annuncio.

VideoDiscoveryAd

Dettagli di 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 di miniature negli annunci video discovery.

Enum
THUMBNAIL_UNSPECIFIED Sconosciuto o non specificato.
THUMBNAIL_DEFAULT La miniatura predefinita, che 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

I dettagli di un annuncio video basato sul rendimento.

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

string

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

trackingUrl

string

Solo output. L'indirizzo URL caricato in background per il monitoraggio.

Nella versione 4 e precedenti, questo campo rappresenta l'URL di monitoraggio specificato manualmente dall'utente. Puoi trovarlo in userSpecifiedTrackingUrl nella versione 5.

userSpecifiedTrackingUrl

string

Facoltativo. L'URL di monitoraggio specificato manualmente dall'utente.

actionButtonLabels[]

string

Facoltativo. L'elenco degli asset di testo mostrati sul pulsante call to action.

Deve essere impostato se è impostato headlines.

headlines[]

string

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

longHeadlines[]

string

Facoltativo. L'elenco dei titoli lunghi mostrati nel banner di invito all'azione.

Deve essere impostato, a meno che il campo lineItemType dell'elemento pubblicitario principale non sia LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE, nel qual caso questo campo non può essere impostato.

descriptions[]

string

Facoltativo. L'elenco delle descrizioni mostrate nel banner di invito all'azione.

Deve essere impostato, a meno che il campo lineItemType dell'elemento pubblicitario principale non sia LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE, nel qual caso questo campo non può essere impostato.

displayUrlBreadcrumb1

string

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

displayUrlBreadcrumb2

string

Facoltativo. La seconda parte dopo il dominio nell'URL di visualizzazione.

Può essere impostato solo se è impostato anche displayUrlBreadcrumb1.

domain

string

Solo output. Il dominio dell'URL di visualizzazione.

videos[]

object (YoutubeVideoDetails)

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

customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori associati da aggiungere all'URL di monitoraggio.

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

companionBanners[]

object (ImageAsset)

Facoltativo. L'elenco dei banner companion utilizzati da questo annuncio.

businessName

string

Facoltativo. Il nome dell'attività mostrato nell'annuncio.

Questa impostazione è obbligatoria, a meno che non venga impostato un valore predefinito a livello di inserzionista. Se non viene impostato, verrà applicato il valore predefinito.

DemandGenVideoAd

Dettagli di un annuncio video Demand Gen.

Rappresentazione JSON
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
Campi
finalUrl

string

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

trackingUrl

string

Solo output. L'indirizzo URL caricato in background per il monitoraggio.

userSpecifiedTrackingUrl

string

Facoltativo. L'URL di monitoraggio specificato manualmente dall'utente.

callToAction

enum (CallToAction)

Obbligatorio. Il pulsante call to action mostrato nell'annuncio.

I valori supportati sono:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

Obbligatorio. L'elenco dei titoli mostrati nell'annuncio.

longHeadlines[]

string

Obbligatorio. L'elenco dei titoli lunghi mostrati nell'annuncio.

descriptions[]

string

Obbligatorio. L'elenco delle descrizioni mostrate nell'annuncio.

displayUrlBreadcrumb1

string

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

displayUrlBreadcrumb2

string

Facoltativo. La seconda parte dopo il dominio nell'URL di visualizzazione.

videos[]

object (YoutubeVideoDetails)

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

customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori associati da aggiungere all'URL di monitoraggio.

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

companionBanner

object (ImageAsset)

Facoltativo. Il banner companion utilizzato da questo annuncio.

finalMobileUrl

string

Facoltativo. L'indirizzo URL della pagina web che gli utenti raggiungono dopo aver fatto clic sull'annuncio su un dispositivo mobile.

finalUrlSuffix

string

Facoltativo. Il suffisso da aggiungere agli URL pagina di destinazione.

businessName

string

Facoltativo. Il nome dell'attività mostrato nell'annuncio.

Questa impostazione è obbligatoria, a meno che non venga impostato un valore predefinito a livello di inserzionista. Se non viene impostato, verrà applicato il valore predefinito.

CallToAction

Possibili valori di invito all'azione per gli annunci di prodotto/video Demand Gen.

Enum
CALL_TO_ACTION_UNSPECIFIED Non specificato o sconosciuto.
AUTOMATED Automatiche.
LEARN_MORE Ulteriori informazioni.
GET_QUOTE Richiedi preventivo.
APPLY_NOW Richiedi ora.
SIGN_UP Registrati.
CONTACT_US Contattaci.
SUBSCRIBE Iscriviti.
DOWNLOAD Scarica.
BOOK_NOW Prenota ora.
SHOP_NOW Acquista ora.
BUY_NOW Acquistalo subito.
DONATE_NOW Fai una donazione ora.
ORDER_NOW Ordina ora.
PLAY_NOW Gioca ora.
SEE_MORE Scopri di più.
START_NOW Inizia ora.
VISIT_SITE Visita il sito.
WATCH_NOW Guarda ora.

DemandGenImageAd

Dettagli di un annuncio illustrato Demand Gen.

Rappresentazione JSON
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
Campi
finalUrl

string

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

trackingUrl

string

Solo output. L'indirizzo URL caricato in background per il monitoraggio.

userSpecifiedTrackingUrl

string

Facoltativo. L'URL di monitoraggio specificato manualmente dall'utente.

callToAction

string

Obbligatorio. Il pulsante call to action mostrato nell'annuncio.

headlines[]

string

Obbligatorio. L'elenco dei titoli mostrati nell'annuncio.

descriptions[]

string

Obbligatorio. L'elenco delle descrizioni mostrate nell'annuncio.

customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori associati da aggiungere all'URL di monitoraggio.

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

finalMobileUrl

string

Facoltativo. L'indirizzo URL della pagina web che gli utenti raggiungono dopo aver fatto clic sull'annuncio su un dispositivo mobile.

finalUrlSuffix

string

Facoltativo. Il suffisso da aggiungere agli URL pagina di destinazione.

businessName

string

Facoltativo. Il nome dell'attività mostrato nell'annuncio.

Questa impostazione è obbligatoria, a meno che non venga impostato un valore predefinito a livello di inserzionista. Se non viene impostato, verrà applicato il valore predefinito.

marketingImages[]

object (ImageAsset)

L'elenco delle immagini di marketing mostrate nell'annuncio.

squareMarketingImages[]

object (ImageAsset)

L'elenco delle immagini di marketing quadrate mostrate nell'annuncio.

portraitMarketingImages[]

object (ImageAsset)

L'elenco delle immagini di marketing verticali mostrate nell'annuncio.

logoImages[]

object (ImageAsset)

L'elenco delle immagini del logo mostrate nell'annuncio.

Questa impostazione è obbligatoria, a meno che non venga impostato un valore predefinito a livello di inserzionista. Se non viene impostato, verrà applicato il valore predefinito.

DemandGenCarouselAd

Dettagli di un annuncio carosello Demand Gen.

Rappresentazione JSON
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
Campi
finalUrl

string

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

headline

string

Obbligatorio. Titolo dell'annuncio.

description

string

Obbligatorio. La descrizione dell'annuncio.

cards[]

object (CarouselCard)

Obbligatorio. L'elenco delle schede mostrate nell'annuncio.

finalUrlSuffix

string

Facoltativo. Il suffisso da aggiungere agli URL pagina di destinazione.

trackingUrl

string

Solo output. L'indirizzo URL caricato in background per il monitoraggio.

userSpecifiedTrackingUrl

string

Facoltativo. L'URL di monitoraggio specificato manualmente dall'utente.

businessName

string

Facoltativo. Il nome dell'attività mostrato nell'annuncio.

Questa impostazione è obbligatoria, a meno che non venga impostato un valore predefinito a livello di inserzionista. Se non viene impostato, verrà applicato il valore predefinito.

customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori associati da aggiungere all'URL di monitoraggio.

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

CarouselCard

Dettagli di una scheda carosello Demand Gen.

Rappresentazione JSON
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Campi
finalUrl

string

Obbligatorio. L'indirizzo URL della pagina web che gli utenti raggiungono dopo aver fatto clic sulla scheda.

finalMobileUrl

string

Facoltativo. L'indirizzo URL della pagina web che gli utenti raggiungono dopo aver fatto clic sulla scheda su un dispositivo mobile.

headline

string

Obbligatorio. Il titolo della scheda.

callToAction

string

Obbligatorio. Il testo del pulsante call to action mostrato nella scheda.

Deve contenere massimo 10 caratteri.

marketingImage

object (ImageAsset)

Facoltativo. L'immagine di marketing mostrata sulla scheda.

squareMarketingImage

object (ImageAsset)

Facoltativo. L'immagine marketing quadrata mostrata nella scheda.

portraitMarketingImage

object (ImageAsset)

Facoltativo. L'immagine marketing verticale mostrata nella scheda.

DemandGenProductAd

Dettagli di un annuncio di prodotto Demand Gen.

Rappresentazione JSON
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
Campi
finalUrl

string

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

headline

string

Obbligatorio. Titolo dell'annuncio.

description

string

Obbligatorio. La descrizione dell'annuncio.

finalUrlSuffix

string

Facoltativo. Il suffisso da aggiungere agli URL pagina di destinazione.

callToAction

enum (CallToAction)

Obbligatorio. Il pulsante call to action mostrato nell'annuncio.

I valori supportati sono:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

Solo output. L'indirizzo URL caricato in background per il monitoraggio.

userSpecifiedTrackingUrl

string

Facoltativo. L'URL di monitoraggio specificato manualmente dall'utente.

businessName

string

Facoltativo. Il nome dell'attività mostrato nell'annuncio.

Questa impostazione è obbligatoria, a meno che non venga impostato un valore predefinito a livello di inserzionista. Se non viene impostato, verrà applicato il valore predefinito.

customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori associati da aggiungere all'URL di monitoraggio.

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

displayUrlBreadcrumb1

string

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

displayUrlBreadcrumb2

string

Facoltativo. La seconda parte dopo il dominio nell'URL di visualizzazione.

AdPolicy

Una singola norma relativa agli annunci associata a un annuncio del gruppo di annunci.

Rappresentazione JSON
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Campi
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

Lo stato di approvazione delle norme di un annuncio, che indica la decisione di approvazione.

adPolicyReviewStatus

enum (AdPolicyReviewStatus)

Lo stato di revisione secondo le norme di un annuncio, che indica la fase della procedura di revisione in cui si trova l'annuncio.

adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Le voci per ogni argomento delle norme identificato come correlato all'annuncio. Ogni voce include l'argomento, il livello di limitazione e le indicazioni su come risolvere il problema relativo alle norme.

AdPolicyApprovalStatus

Possibili stati di approvazione delle norme relative agli annunci.

Enum
AD_POLICY_APPROVAL_STATUS_UNKNOWN Sconosciuto o non specificato.
DISAPPROVED Non verrà pubblicato.
APPROVED_LIMITED Verrà pubblicato con limitazioni.
APPROVED Verrà pubblicato senza limitazioni.
AREA_OF_INTEREST_ONLY Gli annunci non verranno pubblicati nei paesi target, ma potrebbero essere pubblicati per gli utenti che cercano informazioni sui paesi target.

AdPolicyReviewStatus

Possibili stati di una revisione secondo le norme relative agli annunci.

Enum
AD_POLICY_REVIEW_STATUS_UNKNOWN Sconosciuto o non specificato.
REVIEW_IN_PROGRESS Attualmente in corso di revisione.
REVIEWED Revisione principale completata. Altre revisioni potrebbero essere ancora in corso.
UNDER_APPEAL Inviato nuovamente per l'approvazione o è stato presentato un ricorso contro una decisione relativa alle norme.
ELIGIBLE_MAY_SERVE Ritenuto idoneo e potrebbe essere pubblicato. Potrebbe comunque essere necessaria un'ulteriore revisione.

AdPolicyTopicEntry

Una voce che descrive come un annuncio è stato identificato come correlato a una norma relativa agli annunci.

Rappresentazione JSON
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Campi
policyTopic

string

L'argomento delle norme.

Ad esempio, "TRADEMARKS", "ALCOHOL" e così via.

policyLabel

string

Testo dell'etichetta localizzato per la policy.

Ad esempio, "Marchi nel testo", "Contiene alcol" e così via.

policyTopicDescription

string

Una breve descrizione riepilogativa dell'argomento delle norme.

policyTopicType

enum (AdPolicyTopicEntryType)

In che modo la pubblicazione degli annunci sarà interessata dalla relazione con l'argomento delle norme relative agli annunci.

policyDecisionType

enum (AdPolicyDecisionType)

L'origine della decisione relativa alle norme.

policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

I mezzi di applicazione delle norme utilizzati nella revisione secondo le norme.

policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Le prove utilizzate nella decisione relativa alle norme.

policyTopicConstraints[]

object (AdPolicyTopicConstraint)

I vincoli di pubblicazione pertinenti alla decisione relativa alle norme.

appealInfo

object (AdPolicyTopicAppealInfo)

Informazioni su come presentare ricorso contro la decisione relativa alle norme.

AdPolicyTopicEntryType

Possibili impatti sulla pubblicazione di un argomento delle norme relative agli annunci.

Enum
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Sconosciuto o non specificato.
PROHIBITED La risorsa non verrà pubblicata.
FULLY_LIMITED La risorsa non verrà pubblicata in tutti i paesi target.
LIMITED La risorsa non può essere pubblicata in alcuni paesi.
DESCRIPTIVE La risorsa può essere pubblicata.
BROADENING La risorsa può essere pubblicata e potrebbe essere pubblicata oltre la copertura normale.
AREA_OF_INTEREST_ONLY La risorsa è limitata per tutti i paesi target, ma potrebbe essere pubblicata per gli utenti che cercano informazioni sui paesi target.

AdPolicyDecisionType

Possibili origini di una decisione relativa alle norme.

Enum
AD_POLICY_DECISION_TYPE_UNKNOWN Sconosciuto o non specificato.
PURSUANT_TO_NOTICE La decisione è stata presa in seguito a una notifica legale, un'ingiunzione del tribunale o un reclamo del proprietario dei contenuti del marchio e così via.
GOOGLE_INVESTIGATION La decisione è il risultato di un'indagine di Google.

AdPolicyEnforcementMeans

Possibili mezzi di applicazione delle norme utilizzati nella revisione secondo le norme.

Enum
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Sconosciuto o non specificato.
AUTOMATED La procedura di applicazione è stata completamente automatizzata.
HUMAN_REVIEW Un essere umano è stato parzialmente o completamente coinvolto nel processo di applicazione della decisione.

AdPolicyTopicEvidence

Informazioni sulle prove utilizzate nella decisione relativa alle norme.

Rappresentazione JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
Campi
Le prove della decisione relativa alle norme. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
textList

object (TextList)

Elenco delle prove trovate nel testo dell'annuncio.

websiteList

object (WebsiteList)

Elenco dei siti web collegati all'annuncio.

httpCode

integer

Il codice HTTP restituito quando è stata eseguita la scansione dell'URL finale.

languageCode

string

La lingua in cui è stato rilevato l'annuncio.

Questo campo utilizza i tag per le lingue IETF, ad esempio "en-US".

destinationTextList

object (DestinationTextList)

Il testo nella destinazione dell'annuncio che causa una violazione delle norme.

destinationMismatch

object (DestinationMismatch)

Una mancata corrispondenza tra gli URL di destinazione degli annunci.

destinationNotWorking

object (DestinationNotWorking)

Informazioni sugli errori HTTP o DNS relativi alla destinazione annuncio.

trademark

object (Trademark)

Termini relativi ai marchi che hanno causato una violazione delle norme.

legalRemoval

object (LegalRemoval)

Applicazione di norme di natura legale che ha causato una violazione delle norme.

counterfeit

object (Counterfeit)

Applicazione delle norme relative alla contraffazione che ha causato una violazione delle norme.

regionalRequirements

object (RegionalRequirements)

Applicazione proattiva di T&S che ha causato una violazione delle norme.

Fine dei campi che si escludono a vicenda.

TextList

Un elenco di frammenti di testo che hanno violato le norme.

Rappresentazione JSON
{
  "texts": [
    string
  ]
}
Campi
texts[]

string

I frammenti di testo della risorsa che hanno causato il rilevamento della violazione delle policy.

WebsiteList

Un elenco di siti web che hanno violato le norme.

Rappresentazione JSON
{
  "websites": [
    string
  ]
}
Campi
websites[]

string

Siti web che hanno causato il rilevamento della violazione delle norme.

DestinationTextList

Un elenco di testi di destinazione che hanno violato le norme.

Rappresentazione JSON
{
  "destinationTexts": [
    string
  ]
}
Campi
destinationTexts[]

string

Testo di destinazione che ha causato il rilevamento della violazione delle norme.

DestinationMismatch

Dettagli su una mancata corrispondenza tra i tipi di URL di destinazione.

Rappresentazione JSON
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Campi
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

L'insieme di URL che non corrispondono. L'elenco può includere uno o più tipi di URI.

Esempio 1: [DISPLAY_URL, FINAL_URL] significa che l'URL di visualizzazione dell'annuncio non corrisponde all'URL finale dell'annuncio.

Esempio 2: [FINAL_URL] indica che l'URL finale dell'annuncio non corrispondeva all'URL di scansione, il che è considerato anche una mancata corrispondenza della destinazione.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Possibili tipi di URL.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Non specificato o sconosciuto.
DISPLAY_URL L'URL di visualizzazione.
FINAL_URL L'URL finale.
FINAL_MOBILE_URL L'URL mobile finale.
TRACKING_URL L'URL di monitoraggio.
MOBILE_TRACKING_URL L'URL di monitoraggio mobile.

DestinationNotWorking

Dettagli sugli errori HTTP o DNS relativi alla destinazione annuncio.

Rappresentazione JSON
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
Campi
expandedUri

string

L'URL completo che non ha funzionato.

device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Il dispositivo su cui la visita all'URL ha generato l'errore.

lastCheckedTime

string (Timestamp format)

L'ultima volta che l'errore è stato rilevato durante la navigazione all'URL.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

L'errore HTTP o DNS. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Il tipo di errore DNS.

httpErrorCode

string (int64 format)

Il codice di errore HTTP.

Fine dei campi che si escludono a vicenda.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Possibili tipi di errori DNS.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Non specificato o sconosciuto.
HOSTNAME_NOT_FOUND Nome host non trovato nel DNS durante il recupero della pagina di destinazione.
GOOGLE_CRAWLER_DNS_ISSUE Google non è riuscita a eseguire la scansione della pagina di destinazione durante la comunicazione con il DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Possibili dispositivi che hanno riscontrato un errore durante la visita all'URL.

Enum
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Non specificato o sconosciuto.
DESKTOP Computer.
ANDROID Dispositivo Android.
IOS Dispositivo iOS.

Marchio

Termini relativi ai marchi che hanno causato una violazione delle norme.

Rappresentazione JSON
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campi
owner

string

Il proprietario dei contenuti del marchio.

term

string

Il termine del marchio.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

Paesi in cui la violazione delle norme è pertinente.

AdPolicyCriterionRestriction

Rappresenta una limitazione in base al paese.

Rappresentazione JSON
{
  "countryCriterionId": string,
  "countryLabel": string
}
Campi
countryCriterionId

string (int64 format)

L'ID criterio del paese.

countryLabel

string

Nome localizzato del paese. Può essere vuoto.

LegalRemoval

Applicazione di norme di natura legale, ai sensi del DMCA o di normative legali locali.

Rappresentazione JSON
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
Campi
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Il tipo di reclamo che ha causato la rimozione per motivi legali.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

I paesi soggetti a limitazioni in base al paese a causa della rimozione per motivi legali.

restrictedUris[]

string

Gli URL limitati a causa della rimozione per motivi legali.

Dettagli sul tipo di rimozione per motivi legali. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
dmca

object (Dmca)

Dettagli sulla rimozione per motivi legali ai sensi del DMCA.

Fine dei campi che si escludono a vicenda.

Dmca

Dettagli del reclamo relativo al DMCA.

Rappresentazione JSON
{
  "complainant": string
}
Campi
complainant

string

La persona giuridica che ha presentato il reclamo per contenuti illegali.

LocalLegal

Dettagli delle normative legali locali.

Rappresentazione JSON
{
  "lawType": string
}
Campi
lawType

string

Tipo di legge per la nota legale.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Possibili tipi di reclamo per la rimozione per motivi legali.

Enum
COPYRIGHT

Copyright.

Si applica solo al DMCA.

COURT_ORDER

Ingiunzione del tribunale.

Si applica solo alle normative locali.

Contraffazione

Dettagli sull'applicazione delle norme relative alla contraffazione che ha causato una violazione delle norme.

Rappresentazione JSON
{
  "owners": [
    string
  ]
}
Campi
owners[]

string

I proprietari dei contenuti o dei prodotti che hanno presentato un reclamo.

RegionalRequirements

Applicazione proattiva delle norme di Trust & Safety (T&S) per soddisfare i requisiti regionali. Questa è considerata un'indagine di proprietà di Google anziché una notifica di regolamentazione, poiché si tratta di un'applicazione proattiva di T&S.

Rappresentazione JSON
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Campi
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Elenco dei requisiti regionali.

RegionalRequirementsEntry

Dettagli della violazione legale a livello di norme regionali.

Rappresentazione JSON
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campi
legalPolicy

string

Le norme legali che vengono violate.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

I paesi soggetti a limitazioni a causa delle norme legali.

AdPolicyTopicConstraint

Dettagli sui vincoli di pubblicazione degli annunci.

Rappresentazione JSON
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
Campi
Il vincolo di pubblicazione. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
countryConstraint

object (AdPolicyCountryConstraintList)

Paesi in cui l'annuncio non può essere pubblicato.

resellerConstraint

object (AdPolicyResellerConstraint)

Vincolo del rivenditore.

certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Paesi in cui è richiesto un certificato per la pubblicazione.

certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Paesi in cui il dominio della risorsa non è coperto dai certificati associati.

globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Per poter pubblicare annunci in qualsiasi paese è necessario un certificato.

globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Il certificato è obbligatorio per la pubblicazione in qualsiasi paese e quello esistente non copre il dominio dell'annuncio.

Fine dei campi che si escludono a vicenda.

AdPolicyCountryConstraintList

Un elenco di paesi in cui l'annuncio non può essere pubblicato a causa di vincoli previsti dalle norme.

Rappresentazione JSON
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Campi
countries[]

object (AdPolicyCriterionRestriction)

Paesi in cui l'annuncio non può essere pubblicato.

AdPolicyResellerConstraint

Questo tipo non ha campi.

L'argomento delle norme è stato limitato a causa della mancata approvazione del sito web per scopi di rivendita.

AdPolicyGlobalCertificateMissingConstraint

Questo tipo non ha campi.

Per poter pubblicare annunci in qualsiasi paese è necessario un certificato.

AdPolicyGlobalCertificateDomainMismatchConstraint

Questo tipo non ha campi.

Il certificato è obbligatorio per la pubblicazione in qualsiasi paese e quello esistente non copre il dominio dell'annuncio.

AdPolicyTopicAppealInfo

Informazioni su come presentare ricorso contro una decisione relativa alle norme.

Rappresentazione JSON
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Campi
appealType

enum (AdPolicyAppealType)

Se è possibile presentare ricorso contro la decisione tramite un ricorso self-service o un modulo per i ricorsi.

AdPolicyAppealType

Possibili tipi di ricorso.

Enum
AD_POLICY_APPEAL_TYPE_UNKNOWN Sconosciuto o non specificato.
SELF_SERVICE_APPEAL È possibile presentare ricorso contro la decisione tramite un ricorso self-service.
APPEAL_FORM È possibile presentare ricorso contro la decisione utilizzando un modulo per i ricorsi.

AdUrl

URL aggiuntivi correlati all'annuncio, inclusi i beacon.

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

enum (AdUrlType)

Il tipo di URL annuncio.

url

string

Il valore della stringa dell'URL.

AdUrlType

Possibili tipi di URL annuncio.

Enum
AD_URL_TYPE_UNSPECIFIED Sconosciuto o non specificato.
AD_URL_TYPE_BEACON_IMPRESSION Un pixel di monitoraggio 1 x 1 per inviare un 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 espansa in diversi beacon.
AD_URL_TYPE_BEACON_CLICK URL di monitoraggio da contattare quando viene attivato l'evento di clic.
AD_URL_TYPE_BEACON_SKIP URL di monitoraggio da contattare quando viene attivato l'evento di salto.

DcmTrackingInfo

Dettagli sul monitoraggio DCM.

Rappresentazione JSON
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
Campi
placementId

string (int64 format)

Obbligatorio. L'ID posizionamento DCM.

trackingAdId

string (int64 format)

Obbligatorio. L'ID annuncio di monitoraggio DCM.

creativeId

string (int64 format)

Obbligatorio. L'ID creatività DCM.

Metodi

create

Crea un annuncio del gruppo di annunci.

delete

Elimina un annuncio del gruppo di annunci.

get

Recupera un annuncio del gruppo di annunci.

list

Elenca gli annunci del gruppo di annunci.

patch

Aggiorna un annuncio del gruppo di annunci.