REST Resource: customers.ads

FinalAppUrl

Un URL per i link diretti a un'app per il sistema operativo specificato.

Rappresentazione JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Campi
osType

enum (AppUrlOperatingSystemType)

Il sistema operativo scelto come target dall'URL. obbligatorio.
url

string

L'URL del link diretto all'app. I link diretti specificano la posizione di un'app corrispondente ai contenuti che vuoi mostrare e il formato deve essere {scheme}://{host_path}. Lo schema identifica l'app da aprire. Per la tua app, puoi utilizzare uno schema personalizzato che inizi con il nome dell'app. L'host e il percorso specificano la posizione univoca nell'app in cui si trovano i contenuti. Esempio: "exampleapp://productid_1234". obbligatorio.

AppUrlOperatingSystemType

Sistema operativo

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
IOS Il sistema operativo Apple IOS.
ANDROID Il sistema operativo Android.

CustomParameter

Una mappatura che può essere utilizzata dai tag di parametri personalizzati in un elemento trackingUrlTemplate, finalUrls o mobile_final_urls.

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string

La chiave corrispondente al nome del tag del parametro.
value

string

Il valore da sostituire.

AdType

I tipi possibili di annuncio.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
TEXT_AD L'annuncio è un annuncio di testo.
EXPANDED_TEXT_AD Si tratta di un annuncio di testo espanso.
EXPANDED_DYNAMIC_SEARCH_AD L'annuncio è un annuncio dinamico della rete di ricerca espanso.
HOTEL_AD L'annuncio è un annuncio per hotel.
SHOPPING_SMART_AD L'annuncio è un annuncio Shopping intelligente.
SHOPPING_PRODUCT_AD L'annuncio è un annuncio Shopping standard.
VIDEO_AD L'annuncio è un annuncio video.
IMAGE_AD Questo è un annuncio illustrato.
RESPONSIVE_SEARCH_AD L'annuncio è un annuncio adattabile della rete di ricerca.
LEGACY_RESPONSIVE_DISPLAY_AD L'annuncio è un annuncio display adattabile precedente.
APP_AD L'annuncio è un annuncio per app.
LEGACY_APP_INSTALL_AD L'annuncio è un annuncio per l'installazione di app precedente.
RESPONSIVE_DISPLAY_AD L'annuncio è un annuncio display adattabile.
LOCAL_AD Si tratta di un annuncio locale.
HTML5_UPLOAD_AD L'annuncio è un annuncio da caricamento display con il tipo di prodotto HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD L'annuncio è un annuncio display da caricamento con uno dei tipi di prodotto DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD L'annuncio è un annuncio di coinvolgimento in app.
SHOPPING_COMPARISON_LISTING_AD L'annuncio è un annuncio per il confronto con Shopping.
VIDEO_BUMPER_AD Annuncio bumper video.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Annuncio in-stream non ignorabile video.
VIDEO_OUTSTREAM_AD Annuncio video outstream.
VIDEO_TRUEVIEW_IN_STREAM_AD Annuncio video TrueView in-stream.
VIDEO_RESPONSIVE_AD Annuncio video adattabile.
SMART_CAMPAIGN_AD Annuncio di una campagna intelligente.
CALL_AD Annuncio di chiamata.
APP_PRE_REGISTRATION_AD Annuncio di preregistrazione di app universale.
IN_FEED_VIDEO_AD Annuncio video in-feed.
DISCOVERY_MULTI_ASSET_AD Annuncio discovery basato su più asset.
TRAVEL_AD Annuncio di viaggio.
DISCOVERY_VIDEO_RESPONSIVE_AD Annuncio adattabile video discovery.

Dispositivo

Enumera i dispositivi Google Ads disponibili per il targeting.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
MOBILE Dispositivi mobili dotati di browser completi.
TABLET Tablet dotati di browser completi.
DESKTOP Computer.
CONNECTED_TV Smart TV e console per videogiochi.
OTHER Altri tipi di dispositivi.

UrlCollection

Raccolta di URL codificati con un identificatore univoco.

Rappresentazione JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Campi
finalUrls[]

string

Un elenco di possibili URL finali.
finalMobileUrls[]

string

Un elenco di possibili URL mobili finali.
urlCollectionId

string

Identificatore univoco per questa istanza UrlCollection.
trackingUrlTemplate

string

Modello di URL per creare un URL di monitoraggio.

SystemManagedResourceSource

Enum che elenca le possibili origini delle entità gestite dal sistema.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
AD_VARIATIONS Annuncio dell'esperimento sulle varianti dell'annuncio generato.

TextAdInfo

Un annuncio di testo.

Rappresentazione JSON 
{
  "headline": string,
  "description1": string,
  "description2": string
}
Campi
headline

string

Titolo dell'annuncio.
description1

string

La prima riga della descrizione dell'annuncio.
description2

string

La seconda riga della descrizione dell'annuncio.

ExpandedTextAdInfo

Un annuncio di testo espanso.

Rappresentazione JSON 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Campi
headlinePart1

string

La prima parte del titolo dell'annuncio.
headlinePart2

string

La seconda parte del titolo dell'annuncio.
headlinePart3

string

Terza parte del titolo dell'annuncio.
description

string

La descrizione dell'annuncio.
description2

string

La seconda descrizione dell'annuncio.
path1

string

Il testo che può essere visualizzato accanto all'URL visualizzato dell'annuncio.
path2

string

Testo aggiuntivo che può essere visualizzato accanto all'URL visualizzato dell'annuncio.

CallAdInfo

Un annuncio di chiamata.

Rappresentazione JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Campi
countryCode

string

Il codice paese nell'annuncio.
phoneNumber

string

Il numero di telefono nell'annuncio.
businessName

string

Il nome dell'attività nell'annuncio.
headline1

string

Primo titolo dell'annuncio.
headline2

string

Secondo titolo nell'annuncio.
description1

string

La prima riga della descrizione dell'annuncio.
description2

string

La seconda riga della descrizione dell'annuncio.
callTracked

boolean

Se attivare il monitoraggio delle chiamate per la creatività. L'attivazione del monitoraggio delle chiamate attiva anche le conversioni di chiamata.
disableCallConversion

boolean

Indica se disabilitare la conversione di chiamata per la creatività. Se impostato su true, disattiva le conversioni di chiamata anche quando callTracked è true. Se callTracked è false, questo campo viene ignorato.
phoneNumberVerificationUrl

string

L'URL da utilizzare per la verifica del numero di telefono.
conversionAction

string

L'azione di conversione a cui attribuire una conversione di chiamata. Se non imposti, viene utilizzata un'azione di conversione predefinita. Questo campo ha effetto solo se callTracked è impostato su true. In caso contrario, questo campo viene ignorato.
conversionReportingState

enum (CallConversionReportingState)

Il comportamento di conversione di chiamata di questo annuncio di chiamata. Può utilizzare la propria impostazione di conversione di chiamata, ereditare l'impostazione a livello di account o essere disattivata.
path1

string

Prima parte del testo che può essere aggiunta all'URL nell'annuncio. Campo facoltativo.
path2

string

Seconda parte del testo che può essere aggiunta all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche path1. Campo facoltativo.

CallConversionReportingState

Possibili tipi di dati per uno stato di un'azione di conversione di chiamata.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
DISABLED L'azione di conversione di chiamata è disattivata.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION L'azione di conversione di chiamata utilizzerà il tipo di conversione di chiamata impostato a livello di account.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION L'azione di conversione di chiamata utilizzerà il tipo di conversione di chiamata impostato a livello di risorsa (annunci di sola chiamata/estensioni di chiamata).

ExpandedDynamicSearchAdInfo

Un annuncio dinamico della rete di ricerca espanso.

Rappresentazione JSON 
{
  "description": string,
  "description2": string
}
Campi
description

string

La descrizione dell'annuncio.
description2

string

La seconda descrizione dell'annuncio.

HotelAdInfo

Questo tipo non contiene campi.

Un annuncio per hotel.

ShoppingSmartAdInfo

Questo tipo non contiene campi.

Un annuncio Shopping intelligente

ShoppingProductAdInfo

Questo tipo non contiene campi.

Un annuncio Shopping standard.

ImageAdInfo

Un annuncio illustrato.

Rappresentazione JSON 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Campi
mimeType

enum (MimeType)

Il tipo MIME dell'immagine.
pixelWidth

string (int64 format)

La larghezza in pixel dell'immagine a grandezza originale.
pixelHeight

string (int64 format)

Altezza in pixel dell'immagine a grandezza originale.
imageUrl

string

URL dell'immagine a grandezza originale.
previewPixelWidth

string (int64 format)

La larghezza in pixel dell'immagine delle dimensioni di anteprima.
previewPixelHeight

string (int64 format)

L'altezza in pixel dell'immagine delle dimensioni di anteprima.
previewImageUrl

string

URL dell'immagine delle dimensioni di anteprima.
name

string

Il nome dell'immagine. Se l'immagine è stata creata da un MediaFile, questo è il nome del MediaFile. Se l'immagine è stata creata a partire dai byte, il campo è vuoto.
Campo di unione image. L'immagine da cui creare l'annuncio illustrato. Può essere specificato in due modi. 1. Una risorsa MediaFile esistente. 2. I dati non elaborati dell'immagine sotto forma di byte. image può essere solo uno dei seguenti:
mediaFile

string

La risorsa MediaFile da utilizzare per l'immagine.
data

string (bytes format)

Dati di immagine non elaborati sotto forma di byte.

Una stringa con codifica Base64.
adIdToCopyImageFrom

string (int64 format)

Un ID annuncio da cui copiare l'immagine.

MimeType

Il tipo MIME

Enum
UNSPECIFIED Il tipo MIME non è stato specificato.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
IMAGE_JPEG Tipo MIME di image/jpeg.
IMAGE_GIF Tipo MIME di immagine/gif.
IMAGE_PNG Tipo MIME di immagine/png.
FLASH Tipo MIME di application/x-shockwave-Flash.
TEXT_HTML Tipo MIME di text/html.
PDF Tipo MIME dell'applicazione/pdf.
MSWORD Tipo MIME di application/msword.
MSEXCEL Tipo MIME di application/vnd.ms-excel.
RTF Tipo MIME di application/rtf.
AUDIO_WAV Tipo MIME audio/wav.
AUDIO_MP3 Tipo MIME audio/mp3.
HTML5_AD_ZIP Tipo MIME di application/x-html5-ad-zip.

VideoAdInfo

Un annuncio video.

Rappresentazione JSON 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Campi
video

object (AdVideoAsset)

Gli asset video di YouTube utilizzati per l'annuncio.
Campo di unione format. Schema specifico per il formato per i diversi formati video. format può essere solo uno dei seguenti:
inStream

object (VideoTrueViewInStreamAdInfo)

Formato dell'annuncio video TrueView in-stream.
bumper

object (VideoBumperInStreamAdInfo)

Formato dell'annuncio in-stream bumper video.
outStream

object (VideoOutstreamAdInfo)

Formato dell'annuncio outstream video.
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Formato dell'annuncio in-stream non ignorabile video.
inFeed

object (InFeedVideoAdInfo)

Formato dell'annuncio video in-feed.

AdVideoAsset

Un asset video utilizzato all'interno di un annuncio.

Rappresentazione JSON 
{
  "asset": string
}
Campi
asset

string

Il nome della risorsa Asset di questo video.

VideoTrueViewInStreamAdInfo

Rappresentazione del formato dell'annuncio TrueView in-stream video (annuncio mostrato durante la riproduzione del video, spesso all'inizio, con un pulsante per saltare l'annuncio che compare alcuni secondi nel video).

Rappresentazione JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
Campi
actionButtonLabel

string

Etichetta sul pulsante di invito all'azione che indirizza l'utente all'URL finale dell'annuncio video. Obbligatorio per le campagne TrueView for Action, altrimenti facoltativo.
actionHeadline

string

Testo aggiuntivo visualizzato con il pulsante di invito all'azione per fornire contesto e incoraggiare il clic sul pulsante.
companionBanner

object (AdImageAsset)

Gli asset immagine del banner companion utilizzati con l'annuncio.

AdImageAsset

Un asset immagine utilizzato all'interno di un annuncio.

Rappresentazione JSON 
{
  "asset": string
}
Campi
asset

string

Il nome della risorsa Asset di questa immagine.

VideoBumperInStreamAdInfo

Rappresentazione del formato dell'annuncio in-stream bumper video (annuncio video in-stream non ignorabile molto breve).

Rappresentazione JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Campi
companionBanner

object (AdImageAsset)

Gli asset immagine del banner companion utilizzati con l'annuncio.
actionButtonLabel

string

Etichetta sul pulsante "Invito all'azione" che indirizza l'utente all'URL finale dell'annuncio video.
actionHeadline

string

Testo aggiuntivo visualizzato con il pulsante di invito all'azione per fornire contesto e incoraggiare il clic sul pulsante.

VideoOutstreamAdInfo

Rappresentazione del formato dell'annuncio video outstream (annuncio mostrato insieme a un feed con riproduzione automatica, senza audio).

Rappresentazione JSON 
{
  "headline": string,
  "description": string
}
Campi
headline

string

Titolo dell'annuncio.
description

string

La riga descrittiva.

VideoNonSkippableInStreamAdInfo

Rappresentazione del formato dell'annuncio in-stream non ignorabile video (annuncio video in-stream non ignorabile di 15 secondi).

Rappresentazione JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Campi
companionBanner

object (AdImageAsset)

Gli asset immagine del banner companion utilizzati con l'annuncio.
actionButtonLabel

string

Etichetta sul pulsante "Invito all'azione" che indirizza l'utente all'URL finale dell'annuncio video.
actionHeadline

string

Testo aggiuntivo visualizzato con il pulsante "Invito all'azione" per fornire contesto e incoraggiare il clic sul pulsante.

InFeedVideoAdInfo

Rappresentazione del formato dell'annuncio video in-feed.

Rappresentazione JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
Campi
headline

string

Titolo dell'annuncio.
description1

string

Prima riga di testo dell'annuncio.
description2

string

Seconda riga di testo per l'annuncio.
thumbnail

enum (VideoThumbnail)

Immagine in miniatura del video da utilizzare.

VideoThumbnail

Enum che elenca i possibili tipi di miniatura di un video.

Enum
UNSPECIFIED Il tipo non è stato specificato.
UNKNOWN Il valore ricevuto non è noto in questa versione. Questo è un valore solo risposta.
DEFAULT_THUMBNAIL La miniatura predefinita. Possono essere generati automaticamente o caricati dall'utente.
THUMBNAIL_1 Miniatura 1, generata dal video.
THUMBNAIL_2 Miniatura 2, generata dal video.
THUMBNAIL_3 Miniatura 3, generata dal video.

VideoResponsiveAdInfo

Un annuncio adattabile video.

Rappresentazione JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il titolo breve. Al momento è supportato un solo valore per il titolo breve.
longHeadlines[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il titolo lungo. Al momento, è supportato un solo valore per il titolo lungo.
descriptions[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per la descrizione. Al momento è supportato un solo valore per la descrizione.
callToActions[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il pulsante, ad esempio il pulsante "Invito all'azione". Attualmente è supportato un solo valore per il pulsante.
videos[]

object (AdVideoAsset)

Elenco degli asset video di YouTube utilizzati per l'annuncio. Al momento è supportato un solo valore per l'asset video di YouTube.
companionBanners[]

object (AdImageAsset)

Elenco di asset immagine utilizzati per il banner companion. Al momento è supportato un solo valore per l'asset del banner companion.
breadcrumb1

string

Prima parte del testo visualizzata nell'annuncio con l'URL visualizzato.
breadcrumb2

string

Seconda parte del testo che appare nell'annuncio con l'URL visualizzato.

AdTextAsset

Un asset di testo utilizzato all'interno di un annuncio.

Rappresentazione JSON 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
Campi
pinnedField

enum (ServedAssetFieldType)

Il campo bloccato dell'asset. In questo modo l'asset potrà essere pubblicato solo in questo campo. È possibile bloccare più asset nello stesso campo. Un asset sbloccato o bloccato in un campo diverso non viene pubblicato in un campo in cui è stato bloccato un altro asset.
assetPerformanceLabel

enum (AssetPerformanceLabel)

L'etichetta del rendimento di questo asset di testo.
policySummaryInfo

object (AdAssetPolicySummary)

Il riepilogo delle norme di questo asset di testo.
text

string

Testo dell'asset.

ServedAssetFieldType

I possibili tipi di campi asset.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
HEADLINE_1 L'asset viene utilizzato nel titolo 1.
HEADLINE_2 L'asset viene utilizzato nel titolo 2.
HEADLINE_3 L'asset viene utilizzato nel titolo 3.
DESCRIPTION_1 L'asset viene utilizzato nella descrizione 1.
DESCRIPTION_2 L'asset è utilizzato nella descrizione 2.
CALL Questo asset viene utilizzato come chiamata.
MOBILE_APP Questo asset viene utilizzato come app mobile.
CALLOUT Questo asset viene utilizzato come callout.
STRUCTURED_SNIPPET Questo asset viene utilizzato come snippet strutturato.
PRICE Questo asset viene utilizzato come prezzo.
PROMOTION Questo asset viene utilizzato come promozione.
AD_IMAGE Questo asset viene utilizzato come immagine.
LEAD_FORM L'asset viene utilizzato come modulo per i lead.

AssetPerformanceLabel

Enum che descrive le possibili etichette di rendimento di una risorsa, generalmente calcolate nel contesto di un collegamento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
PENDING Per questo asset non sono ancora disponibili informazioni sul rendimento. Ciò potrebbe essere dovuto al fatto che è ancora in corso di revisione.
LEARNING L'asset ha iniziato a ricevere impressioni, ma le statistiche non sono statisticamente sufficientemente significative da ottenere un'etichetta di rendimento dell'asset.
LOW Asset con il rendimento peggiore.
GOOD Asset con un buon rendimento.
BEST Asset con il rendimento migliore.

AdAssetPolicySummary

Contiene informazioni sulle norme per una risorsa all'interno di un annuncio.

Rappresentazione JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Campi
policyTopicEntries[]

object (PolicyTopicEntry)

L'elenco dei risultati relativi alle norme per questa risorsa.
reviewStatus

enum (PolicyReviewStatus)

Il punto della procedura di revisione di questo asset.
approvalStatus

enum (PolicyApprovalStatus)

Lo stato di approvazione complessivo di questa risorsa, calcolato in base allo stato delle singole voci relative all'argomento delle norme.

PolicyTopicEntry

Risultato delle norme associato a una risorsa (ad esempio, norme sugli alcolici associate a un sito che vende alcolici).

Ogni PolicyTopicEntry include un argomento che indica la specifica norma relativa agli annunci in oggetto e un tipo per indicare l'effetto che la voce avrà sulla pubblicazione. Facoltativamente, potrebbe contenere una o più prove che indicano il motivo dell'esito. Facoltativamente, può anche avere uno o più vincoli che forniscono dettagli su come la pubblicazione potrebbe essere limitata.

Rappresentazione JSON 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
Campi
type

enum (PolicyTopicEntryType)

Descrive l'effetto negativo o positivo che questa norma avrà sulla pubblicazione.
evidences[]

object (PolicyTopicEvidence)

Informazioni aggiuntive che spiegano la scoperta delle norme (ad esempio, il nome del brand per la scoperta di un marchio).
constraints[]

object (PolicyTopicConstraint)

Indica in che modo potrebbe essere interessata la gestione di questa risorsa (ad esempio la mancata pubblicazione in un paese).
topic

string

Argomento delle norme a cui fa riferimento questo risultato. Ad esempio, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT" o "DESTINATION_NOT_WORKING". L'insieme di possibili argomenti delle norme non è stato risolto per una determinata versione dell'API e potrebbe cambiare in qualsiasi momento.

PolicyTopicEntryType

I possibili tipi di voci di argomenti delle norme.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
PROHIBITED La risorsa non verrà fornita.
LIMITED In alcune circostanze, la risorsa non verrà fornita.
FULLY_LIMITED La risorsa non può essere pubblicata a causa dei criteri di targeting attuali.
DESCRIPTIVE Può essere di interesse, ma non limita le modalità di offerta della risorsa.
BROADENING Potrebbe aumentare la copertura oltre la normalità.
AREA_OF_INTEREST_ONLY Vincolata per tutti i paesi di destinazione, ma potrebbe pubblicare annunci in altri paesi in base alle aree di interesse.

PolicyTopicEvidence

Informazioni aggiuntive che spiegano un risultato relativo alle norme.

Rappresentazione JSON 
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
Campi
Campo di unione value. Informazioni sulle prove specifiche a seconda del tipo di prove. value può essere solo uno dei seguenti:
websiteList

object (WebsiteList)

Elenco dei siti web collegati a questa risorsa.
textList

object (TextList)

Elenco delle prove trovate nel testo di una risorsa.
languageCode

string

La lingua in cui è stata rilevata la scrittura della risorsa. Si tratta di un tag per la lingua IETF, ad esempio "en-US".
destinationTextList

object (DestinationTextList)

Il testo nella destinazione della risorsa che causa il rilevamento del criterio.
destinationMismatch

object (DestinationMismatch)

Mancata corrispondenza tra le destinazioni degli URL di una risorsa.
destinationNotWorking

object (DestinationNotWorking)

Dettagli quando la destinazione restituisce un codice di errore HTTP o non funziona in tutte le località per i dispositivi di uso comune.

WebsiteList

Un elenco di siti web che hanno causato il rilevamento delle norme. Utilizzato, ad esempio, per l'argomento del criterio ONE_SITE_PER_AD_GROUP. Se sono presenti più di cinque siti web, solo i primi cinque (ovvero quelli che appaiono più spesso nelle risorse) verranno elencati qui.

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

string

Siti web all'origine della verifica delle norme.

TextList

Un elenco di frammenti di testo che hanno violato una norma.

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

string

I frammenti di testo della risorsa che hanno causato il rilevamento del criterio.

DestinationTextList

Un elenco di stringhe trovate in una pagina di destinazione che ha generato il rilevamento di un criterio.

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

string

Elenco di testo trovato nella pagina di destinazione della risorsa.

DestinationMismatch

Prove di mancate corrispondenze tra gli URL di una risorsa.

Rappresentazione JSON 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Campi
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

L'insieme di URL che non corrispondono.

PolicyTopicEvidenceDestinationMismatchUrlType

I possibili tipi di URL per la mancata corrispondenza della destinazione delle prove relative all'argomento delle norme.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
DISPLAY_URL L'URL di visualizzazione.
FINAL_URL L'URL finale.
FINAL_MOBILE_URL L'URL mobile finale.
TRACKING_URL Il modello di URL di monitoraggio, con URL desktop sostituito.
MOBILE_TRACKING_URL Il modello di URL di monitoraggio, con URL mobile sostituito.

DestinationNotWorking

Le prove dettagliate se la destinazione restituisce un codice di errore HTTP o non funziona in tutte le località per i dispositivi di uso comune.

Rappresentazione JSON 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Campi
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

Il tipo di dispositivo che non è riuscito a caricare l'URL.
expandedUrl

string

L'URL completo che non ha funzionato.
lastCheckedDateTime

string

L'ora dell'ultima verifica dell'URL. Il formato è "AAAA-MM-GG HH:MM:SS". Esempi: "2018-03-05 09:15:00" o "2018-02-01 14:34:30"
Campo di unione reason. Indica il motivo del rilevamento del criterio DESTINATION_NOT_WORKING. reason può essere solo uno dei seguenti:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Il tipo di errore DNS.
httpErrorCode

string (int64 format)

Il codice di errore HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

La possibile destinazione delle prove relative all'argomento delle norme sui dispositivi non funzionanti.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
DESKTOP La pagina di destinazione non funziona sul computer.
ANDROID La pagina di destinazione non funziona sul dispositivo Android.
IOS La pagina di destinazione non funziona sul dispositivo iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

I tipi di errore DNS che potrebbero essere usati per prove di argomenti dei criteri non funzionanti.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
HOSTNAME_NOT_FOUND Nome host non trovato nel DNS durante il recupero della pagina di destinazione.
GOOGLE_CRAWLER_DNS_ISSUE Problema del crawler interno di Google durante la comunicazione con il DNS. Questo errore non significa che la pagina di destinazione non funziona. Google eseguirà nuovamente la scansione della pagina di destinazione.

PolicyTopicConstraint

Descrive l'effetto sulla pubblicazione di una voce relativa a un argomento delle norme.

Rappresentazione JSON 
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
Campi
Campo di unione value. Informazioni specifiche sul vincolo. value può essere solo uno dei seguenti:
countryConstraintList

object (CountryConstraintList)

Paesi in cui la risorsa non può essere pubblicata.
resellerConstraint

object (ResellerConstraint)

Vincolo del rivenditore.
certificateMissingInCountryList

object (CountryConstraintList)

Paesi in cui è richiesto un certificato per l'elaborazione.
certificateDomainMismatchInCountryList

object (CountryConstraintList)

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

CountryConstraintList

Un elenco di paesi in cui la pubblicazione di una risorsa è limitata.

Rappresentazione JSON 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
Campi
countries[]

object (CountryConstraint)

Paesi in cui la pubblicazione è limitata.
totalTargetedCountries

integer

Numero totale di paesi scelti come target dalla risorsa.

CountryConstraint

Indica che la risorsa di una risorsa non può essere pubblicata in un determinato paese è limitata.

Rappresentazione JSON 
{
  "countryCriterion": string
}
Campi
countryCriterion

string

Nome della risorsa costante del targeting geografico del paese in cui la pubblicazione è limitata.

ResellerConstraint

Questo tipo non contiene campi.

Indica che un argomento delle norme è stato limitato a causa della mancata approvazione del sito web per motivi di rivenditore.

PolicyReviewStatus

I possibili stati di revisione secondo le norme.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
REVIEW_IN_PROGRESS Attualmente in corso di revisione.
REVIEWED Revisione principale completata. Le altre revisioni potrebbero essere in corso.
UNDER_APPEAL La risorsa è stata inviata di nuovo per l'approvazione oppure è stato presentato ricorso contro la decisione relativa alle norme.
ELIGIBLE_MAY_SERVE La risorsa è idonea e potrebbe essere pubblicata, ma potrebbe essere ancora sottoposta a ulteriori revisioni.

PolicyApprovalStatus

I possibili stati di approvazione delle norme. Quando sono disponibili diversi stati di approvazione, verrà utilizzato quello più grave. L'ordine di gravità è DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED e APPROVED.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
DISAPPROVED Non verrà pubblicato.
APPROVED_LIMITED Pubblica con limitazioni.
APPROVED Pubblica senza limitazioni.
AREA_OF_INTEREST_ONLY Non verrà pubblicato nei paesi target, ma potrebbe essere mostrato agli utenti che cercano informazioni sui paesi target.

ResponsiveSearchAdInfo

Un annuncio adattabile della rete di ricerca.

Gli annunci adattabili della rete di ricerca consentono di creare un annuncio che cambia in modo da mostrare ai clienti più testo e messaggi più pertinenti. Se durante la creazione di un annuncio adattabile della rete di ricerca inserisci più titoli e descrizioni, nel tempo Google Ads proverà automaticamente diverse combinazioni e capirà quali sono le più efficaci. Adattando i contenuti del tuo annuncio in modo che corrispondano meglio ai termini di ricerca dei potenziali clienti, gli annunci adattabili della rete di ricerca possono migliorare il rendimento della campagna.

Scopri di più all'indirizzo https://support.google.com/google-ads/answer/7684791

Rappresentazione JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli vengono selezionati da questo elenco.
descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni vengono selezionate da questo elenco.
path1

string

Prima parte del testo che può essere aggiunta all'URL nell'annuncio.
path2

string

Seconda parte del testo che può essere aggiunta all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche path1.

LegacyResponsiveDisplayAdInfo

Un annuncio display adattabile precedente. Gli annunci di questo tipo sono etichettati come "Annunci adattabili" nell'interfaccia utente di Google Ads.

Rappresentazione JSON 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Campi
formatSetting

enum (DisplayAdFormatSetting)

Specifica il formato in cui verrà pubblicato l'annuncio. Il valore predefinito è ALL_FORMATS.
shortHeadline

string

La versione breve del titolo dell'annuncio.
longHeadline

string

La versione lunga del titolo dell'annuncio.
description

string

La descrizione dell'annuncio.
businessName

string

Il nome dell'attività nell'annuncio.
allowFlexibleColor

boolean

Consenso dell'inserzionista per consentire il colore flessibile. Se il valore è true, l'annuncio può essere pubblicato con un colore diverso, se necessario. Se il valore è false, l'annuncio verrà pubblicato con i colori specificati o un colore neutro. Il valore predefinito è true. Deve essere true se mainColor e accentColor non sono impostati.
accentColor

string

Il colore intenso dell'annuncio in esadecimale, ad esempio #ffffff per il bianco. Se uno tra mainColor e accentColor è impostato, è necessario anche l'altro.
mainColor

string

Il colore principale dell'annuncio in esadecimale, ad esempio #ffffff per il bianco. Se uno tra mainColor e accentColor è impostato, è necessario anche l'altro.
callToActionText

string

Il testo dell'invito all'azione per l'annuncio.
logoImage

string

Il nome della risorsa MediaFile dell'immagine del logo utilizzata nell'annuncio.
squareLogoImage

string

Il nome della risorsa MediaFile dell'immagine quadrata del logo utilizzata nell'annuncio.
marketingImage

string

Il nome della risorsa MediaFile dell'immagine di marketing utilizzata nell'annuncio.
squareMarketingImage

string

Il nome della risorsa MediaFile dell'immagine di marketing quadrata utilizzata nell'annuncio.
pricePrefix

string

Prefisso prima del prezzo. Ad esempio, "a partire da".
promoText

string

Testo promozionale utilizzato per i formati dinamici degli annunci adattabili. Ad esempio, "Spedizione gratuita in due giorni".

DisplayAdFormatSetting

Enumera le impostazioni del formato dell'annuncio display.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
ALL_FORMATS Formati di testo, illustrati e nativi.
NON_NATIVE Formati di testo e immagini.
NATIVE Formato nativo, ad esempio il rendering del formato è controllato dal publisher e non da Google.

AppAdInfo

Un annuncio per app.

Rappresentazione JSON 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
Campi
mandatoryAdText

object (AdTextAsset)

Testo dell'annuncio obbligatorio.
headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli vengono selezionati da questo elenco.
descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni vengono selezionate da questo elenco.
images[]

object (AdImageAsset)

Elenco di asset immagine che possono essere visualizzati con l'annuncio.
youtubeVideos[]

object (AdVideoAsset)

Elenco degli asset video di YouTube che possono essere visualizzati con l'annuncio.
html5MediaBundles[]

object (AdMediaBundleAsset)

Elenco di asset del bundle multimediale che possono essere utilizzati con l'annuncio.

AdMediaBundleAsset

Un asset del bundle multimediale utilizzato all'interno di un annuncio.

Rappresentazione JSON 
{
  "asset": string
}
Campi
asset

string

Il nome della risorsa Asset di questo bundle multimediale.

LegacyAppInstallAdInfo

Un annuncio per l'installazione di app precedente che può essere utilizzato solo da alcuni clienti selezionati.

Rappresentazione JSON 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Campi
appStore

enum (LegacyAppInstallAdAppStore)

Lo store in cui è disponibile l'app mobile.
appId

string

L'ID dell'app mobile.
headline

string

Titolo dell'annuncio.
description1

string

La prima riga descrittiva dell'annuncio.
description2

string

La seconda riga descrittiva dell'annuncio.

LegacyAppInstallAdAppStore

Tipo di store in un annuncio per l'installazione di app precedente.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
APPLE_APP_STORE iTunes di Apple.
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows Store.
WINDOWS_PHONE_STORE Windows Phone Store.
CN_APP_STORE L'app è ospitata in uno store cinese.

ResponsiveDisplayAdInfo

Un annuncio display adattabile.

Rappresentazione JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Campi
marketingImages[]

object (AdImageAsset)

Immagini marketing da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 600 x 314 e le proporzioni devono essere 1,91:1 (+-1%). È richiesto almeno un marketingImage. Se combinato con squareMarketingImages, il massimo è 15.
squareMarketingImages[]

object (AdImageAsset)

Immagini di marketing quadrate da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 300 x 300 e le proporzioni devono essere 1:1 (+-1%). È necessario indicare almeno un marketingImage quadrato. Se combinato con marketingImages, il massimo è 15.
logoImages[]

object (AdImageAsset)

Immagini del logo da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 512 x 128 e le proporzioni devono essere 4:1 (+-1%). Se combinato con squareLogoImages, il massimo è 5.
squareLogoImages[]

object (AdImageAsset)

Immagini quadrate del logo da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 128 x 128 e le proporzioni devono essere 1:1 (+-1%). Se combinato con logoImages, il massimo è 5.
headlines[]

object (AdTextAsset)

Titoli brevi per l'annuncio. La lunghezza massima è di 30 caratteri. È possibile specificare un minimo di 1 e un massimo di 5 titoli.
longHeadline

object (AdTextAsset)

Un titolo di formato lungo obbligatorio. La lunghezza massima è di 90 caratteri.
descriptions[]

object (AdTextAsset)

Testi descrittivi dell'annuncio. La lunghezza massima è di 90 caratteri. È possibile specificare un minimo di 1 e un massimo di 5 titoli.
youtubeVideos[]

object (AdVideoAsset)

Video di YouTube facoltativi per l'annuncio. È possibile specificare un massimo di 5 video.
formatSetting

enum (DisplayAdFormatSetting)

Specifica il formato in cui verrà pubblicato l'annuncio. Il valore predefinito è ALL_FORMATS.
controlSpec

object (ResponsiveDisplayAdControlSpec)

Specifica per diversi controlli delle creatività.
businessName

string

Il nome dell'inserzionista/brand. La larghezza massima della visualizzazione è 25.
mainColor

string

Il colore principale dell'annuncio in esadecimale, ad esempio #ffffff per il bianco. Se uno tra mainColor e accentColor è impostato, è necessario anche l'altro.
accentColor

string

Il colore intenso dell'annuncio in esadecimale, ad esempio #ffffff per il bianco. Se uno tra mainColor e accentColor è impostato, è necessario anche l'altro.
allowFlexibleColor

boolean

Consenso dell'inserzionista per consentire il colore flessibile. Se il valore è true, l'annuncio può essere pubblicato con un colore diverso, se necessario. Se il valore è false, l'annuncio verrà pubblicato con i colori specificati o un colore neutro. Il valore predefinito è true. Deve essere true se mainColor e accentColor non sono impostati.
callToActionText

string

Il testo dell'invito all'azione per l'annuncio. La larghezza massima della visualizzazione è 30.
pricePrefix

string

Prefisso prima del prezzo. Ad esempio, "a partire da".
promoText

string

Testo promozionale utilizzato per i formati dinamici degli annunci adattabili. Ad esempio, "Spedizione gratuita in due giorni".

ResponsiveDisplayAdControlSpec

Specifica per i vari controlli delle creatività per un annuncio display adattabile.

Rappresentazione JSON 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Campi
enableAssetEnhancements

boolean

Se l'inserzionista ha attivato la funzionalità di miglioramento degli asset.
enableAutogenVideo

boolean

Se l'inserzionista ha attivato la funzionalità video di generazione automatica.

LocalAdInfo

Un annuncio locale.

Rappresentazione JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli vengono selezionati da questo elenco. Devi specificare un minimo di 1 e un massimo di 5 titoli.
descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni vengono selezionate da questo elenco. Devi specificare un minimo di 1 e un massimo di 5 descrizioni.
callToActions[]

object (AdTextAsset)

Elenco di asset di testo per gli inviti all'azione. Quando l'annuncio viene pubblicato, gli inviti all'azione vengono selezionati da questo elenco. Devi specificare un minimo di 1 e un massimo di 5 inviti all'azione.
marketingImages[]

object (AdImageAsset)

Elenco di asset immagine di marketing che possono essere visualizzati con l'annuncio. Le immagini devono essere di 314 x 600 pixel o 320 x 320 pixel. Devi specificare un minimo di 1 e un massimo di 20 asset immagine.
logoImages[]

object (AdImageAsset)

Elenco di asset immagine del logo che possono essere visualizzati con l'annuncio. Le immagini devono essere di 128 x 128 pixel e non devono superare i 120 kB. Devi specificare un minimo di 1 e un massimo di 5 asset immagine.
videos[]

object (AdVideoAsset)

Elenco degli asset video di YouTube che possono essere visualizzati con l'annuncio. Devono essere specificati da un minimo di 1 a un massimo di 20 asset video.
path1

string

Prima parte del testo facoltativo che può essere aggiunta all'URL nell'annuncio.
path2

string

Seconda parte del testo facoltativo che può essere aggiunto all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche path1.

DisplayUploadAdInfo

Un tipo di annuncio display generico. Il formato esatto dell'annuncio è controllato dal campo displayUploadProductType, che determina i tipi di dati da includere nell'annuncio.

Rappresentazione JSON 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Campi
displayUploadProductType

enum (DisplayUploadProductType)

Il tipo di prodotto di questo annuncio. Per informazioni dettagliate, vedi i commenti sull'enumerazione.
Campo di unione media_asset. I dati degli asset che compongono l'annuncio. media_asset può essere solo uno dei seguenti:
mediaBundle

object (AdMediaBundleAsset)

Un asset del bundle multimediale da utilizzare nell'annuncio. Per informazioni sul bundle multimediale per HTML5_UPLOAD_AD, consulta la pagina https://support.google.com/google-ads/answer/1722096. I bundle multimediali che fanno parte di tipi di prodotto dinamici utilizzano un formato speciale che deve essere creato con Google Web Designer. Per ulteriori informazioni, visita la pagina https://support.google.com/webdesigner/answer/7543898.

DisplayUploadProductType

Enumera i tipi di prodotto di caricamento display.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
HTML5_UPLOAD_AD Annuncio da caricamento HTML5. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD Annuncio HTML5 dinamico per l'istruzione. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna educativa.
DYNAMIC_HTML5_FLIGHT_AD Annuncio HTML5 dinamico per il periodo di pubblicazione. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna periodo di pubblicazione.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Annuncio HTML5 dinamico per hotel e affitti. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna per hotel.
DYNAMIC_HTML5_JOB_AD Annuncio di lavoro HTML5 dinamico. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna di offerte di lavoro.
DYNAMIC_HTML5_LOCAL_AD Annuncio locale HTML5 dinamico. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna locale.
DYNAMIC_HTML5_REAL_ESTATE_AD Annuncio immobiliare HTML5 dinamico. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna immobiliare.
DYNAMIC_HTML5_CUSTOM_AD Annuncio HTML5 dinamico personalizzato. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna personalizzata.
DYNAMIC_HTML5_TRAVEL_AD Annuncio HTML5 dinamico per viaggi. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna per viaggi.
DYNAMIC_HTML5_HOTEL_AD Annuncio HTML5 dinamico per hotel. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna per hotel.

AppEngagementAdInfo

Gli annunci di coinvolgimento in app ti consentono di scrivere del testo che incoraggi una specifica azione nell'app, come il check-in, un acquisto o la prenotazione di un volo. Ti consentono di indirizzare gli utenti a una parte specifica dell'app, dove possono trovare ciò che stanno cercando in modo più semplice e veloce.

Rappresentazione JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli vengono selezionati da questo elenco.
descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni vengono selezionate da questo elenco.
images[]

object (AdImageAsset)

Elenco di asset immagine che possono essere visualizzati con l'annuncio.
videos[]

object (AdVideoAsset)

Elenco di asset video che possono essere visualizzati con l'annuncio.

ShoppingComparisonListingAdInfo

Un annuncio per il confronto con Shopping.

Rappresentazione JSON 
{
  "headline": string
}
Campi
headline

string

Titolo dell'annuncio. Questo campo è obbligatorio. La lunghezza consentita è compresa tra 25 e 45 caratteri.

SmartCampaignAdInfo

Un annuncio di una campagna intelligente.

Rappresentazione JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo, ognuno dei quali corrisponde a un titolo quando viene pubblicato l'annuncio. Questo elenco è composto da un minimo di 3 a un massimo di 15 asset di testo.
descriptions[]

object (AdTextAsset)

Elenco di asset di testo, ognuno dei quali corrisponde a una descrizione quando viene pubblicato l'annuncio. Questo elenco è composto da un minimo di 2 a un massimo di 4 asset di testo.

AppPreRegistrationAdInfo

Gli annunci di preregistrazione di app rimandano alla tua app o alla tua scheda del gioco su Google Play e possono essere pubblicati su Google Play, YouTube (solo in-stream) e all'interno di altre app e siti web per dispositivi mobili sulla Rete Display. Ti aiuterà a catturare l'interesse degli utenti per la tua app o il tuo gioco e per generare installazioni attive iniziali per l'app o il gioco prima del lancio.

Rappresentazione JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli vengono selezionati da questo elenco.
descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni vengono selezionate da questo elenco.
images[]

object (AdImageAsset)

Elenco di ID asset immagine le cui immagini possono essere visualizzate con l'annuncio.
youtubeVideos[]

object (AdVideoAsset)

Elenco degli ID asset video di YouTube i cui video possono essere visualizzati con l'annuncio.

DiscoveryMultiAssetAdInfo

Un annuncio discovery con più asset.

Rappresentazione JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Campi
marketingImages[]

object (AdImageAsset)

Asset immagine marketing da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 600 x 314 e le proporzioni devono essere 1,91:1 (+-1%). Obbligatorio se SquareMarketingImages non è presente. Se combinato con squareMarketingImages e portraitMarketingImages, il massimo è 20.
squareMarketingImages[]

object (AdImageAsset)

Asset di immagine di marketing quadrata da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 300 x 300 e le proporzioni devono essere 1:1 (+-1%). Obbligatorio se non è presente marketingImages. Se combinato con marketingImages e portraitMarketingImages, il massimo è 20.
portraitMarketingImages[]

object (AdImageAsset)

Asset di immagini di marketing verticali da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 480 x 600 e le proporzioni devono essere 4:5 (+-1%). Se combinato con marketingImages e squareMarketingImages, il massimo è 20.
logoImages[]

object (AdImageAsset)

Asset immagine del logo da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 128 x 128 e le proporzioni devono essere 1:1 (+-1%). È possibile specificare da un minimo di 1 a un massimo di 5 immagini di logo.
headlines[]

object (AdTextAsset)

Asset di testo del titolo dell'annuncio. La larghezza massima della visualizzazione è 30. È possibile specificare un minimo di 1 e un massimo di 5 titoli.
descriptions[]

object (AdTextAsset)

Il testo descrittivo dell'annuncio. La larghezza massima della visualizzazione è 90. Puoi specificare da un minimo di 1 a un massimo di 5 descrizioni.
businessName

string

Il nome dell'inserzionista/del brand. La larghezza massima della visualizzazione è 25. obbligatorio.
callToActionText

string

Testo dell'invito all'azione.
leadFormOnly

boolean

Opzione booleana che indica se l'annuncio deve essere pubblicato con il modulo per i lead.

DiscoveryCarouselAdInfo

Un annuncio carosello discovery.

Rappresentazione JSON 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
Campi
businessName

string

obbligatorio. Il nome dell'inserzionista/del brand.
logoImage

object (AdImageAsset)

obbligatorio. Immagine del logo da utilizzare nell'annuncio. La dimensione minima è 128 x 128 e le proporzioni devono essere 1:1 (+-1%).
headline

object (AdTextAsset)

obbligatorio. Titolo dell'annuncio.
description

object (AdTextAsset)

obbligatorio. Il testo descrittivo dell'annuncio.
callToActionText

string

Testo dell'invito all'azione.
carouselCards[]

object (AdDiscoveryCarouselCardAsset)

obbligatorio. Schede carosello che verranno visualizzate con l'annuncio. Minimo 2 max 10.

AdDiscoveryCarouselCardAsset

Un asset della scheda carosello discovery utilizzato all'interno di un annuncio.

Rappresentazione JSON 
{
  "asset": string
}
Campi
asset

string

Il nome della risorsa Asset di questa scheda carosello discovery.

DiscoveryVideoResponsiveAdInfo

Un annuncio adattabile video discovery.

Rappresentazione JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il titolo breve.
longHeadlines[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il titolo lungo.
descriptions[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per la descrizione.
videos[]

object (AdVideoAsset)

Elenco degli asset video di YouTube utilizzati per l'annuncio.
logoImages[]

object (AdImageAsset)

Immagine del logo da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. La dimensione minima è 128 x 128 e le proporzioni devono essere 1:1 (+-1%).
breadcrumb1

string

Prima parte del testo visualizzata nell'annuncio con l'URL visualizzato.
breadcrumb2

string

Seconda parte del testo che appare nell'annuncio con l'URL visualizzato.
businessName

object (AdTextAsset)

obbligatorio. Il nome dell'inserzionista/brand.
callToActions[]

object (AdCallToActionAsset)

Asset di tipo CallToActionAsset utilizzati per il pulsante "Invito all'azione".

AdCallToActionAsset

Un asset di invito all'azione utilizzato all'interno di un annuncio.

Rappresentazione JSON 
{
  "asset": string
}
Campi
asset

string

Il nome della risorsa di questo asset di invito all'azione.

TravelAdInfo

Questo tipo non contiene campi.

Un annuncio di viaggi.

Metodi

get

 Restituisce l'annuncio richiesto in modo dettagliato.

mutate

 Aggiorna gli annunci.