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)
    }
  ],

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

string

Il nome della risorsa dell'annuncio.
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

.
displayName

string

Il nome visualizzato dell'annuncio.

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

object (AdPolicy)

Lo stato di approvazione delle norme dell'annuncio.
entityStatus

enum (EntityStatus)

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

object (AdUrl)

Elenco degli URL utilizzati dall'annuncio.

Campo unione ad_details. I dettagli dell'annuncio.

ad_details può essere solo uno dei seguenti:
displayVideoSourceAd

object (DisplayVideoSourceAd)

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

object (MastheadAd)

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

object (InStreamAd)

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

object (NonSkippableAd)

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

object (BumperAd)

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

object (AudioAd)

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

object (VideoDiscoveryAd)

Dettagli di un annuncio che promuove un video visualizzato nei luoghi di scoperta.
videoPerformanceAd

object (VideoPerformanceAd)

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

AdPolicy

Una singola norma sugli 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 delle norme di un annuncio, che indica a che punto della procedura di revisione si trova l'annuncio.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Le voci relative a ogni argomento delle norme identificato come pertinente all'annuncio. Ogni voce include l'argomento, il livello di limitazione e indicazioni su come risolvere i problemi relativi 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 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 fase di revisione.
REVIEWED Revisione principale completata. Altre revisioni potrebbero essere ancora in corso.
UNDER_APPEAL È stato inviato nuovamente per l'approvazione o è stato presentato ricorso contro una decisione relativa alle norme.
ELIGIBLE_MAY_SERVE Considerato idoneo e potrebbe essere pubblicato. Potrebbe comunque seguire un'ulteriore revisione.

AdPolicyTopicEntry

Una voce che descrive in che modo un annuncio è stato identificato come correlato a una norma pubblicitaria.

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.

Alcuni esempi includono "MARCHI", "ALCOLICI" e così via.
policyLabel

string

Testo dell'etichetta localizzato per le norme.

Alcuni esempi includono "Marchi nel testo", "Contiene alcol" e così via.
policyTopicDescription

string

Un breve riepilogo dell'argomento delle norme.
policyTopicType

enum (AdPolicyTopicEntryType)

In che modo la pubblicazione degli annunci sarà interessata a causa della relazione con l'argomento delle norme pubblicitarie.
policyDecisionType

enum (AdPolicyDecisionType)

L'origine della decisione relativa alle norme.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Il mezzo di applicazione delle norme utilizzato nella revisione delle 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 pubblicitarie.

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 può essere pubblicata per gli utenti che cercano informazioni sui paesi target.

AdPolicyDecisionType

Possibili fonti di una decisione relativa alle norme.

Enum
AD_POLICY_DECISION_TYPE_UNKNOWN Sconosciuto o non specificato.
PURSUANT_TO_NOTICE La decisione deriva da una notifica legale, un'ingiunzione del tribunale, un reclamo del proprietario dei contenuti del marchio e così via.
GOOGLE_INVESTIGATION La decisione è il risultato di un'indagine di proprietà di Google.

AdPolicyEnforcementMeans

Possibili mezzi di applicazione delle norme utilizzati nella revisione delle 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 coinvolto parzialmente o completamente nel processo di applicazione della decisione.

AdPolicyTopicEvidence

Informazioni sulle prove utilizzate nella decisione relativa alle norme.

Rappresentazione JSON 
{

  // Union field value can be only one of the following:
  "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 list of possible types for union field value.
}
Campi
Campo unione value. Le prove della decisione relativa alle norme. value può essere solo uno dei seguenti:
textList

object (TextList)

Elenco delle prove trovate nel testo dell'annuncio.
websiteList

object (WebsiteList)

Elenco dei siti web collegati all'annuncio.
httpCode

integer

Codice HTTP restituito durante la scansione dell'URL finale.
languageCode

string

La lingua in cui è stato rilevato che è scritto l'annuncio.

Questo campo utilizza i tag di lingua 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 dell'annuncio.
destinationNotWorking

object (DestinationNotWorking)

Informazioni sugli errori HTTP o DNS relativi alla destinazione dell'annuncio.
trademark

object (Trademark)

Termini del marchio che hanno causato una violazione delle norme.
legalRemoval

object (LegalRemoval)

Applicazione di normative correlate a questioni legali che ha causato una violazione delle norme.
counterfeit

object (Counterfeit)

Applicazione di misure 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.

TextList

Un elenco di frammenti di testo che violano le norme.

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

string

I frammenti di testo della risorsa che hanno causato il risultato della policy.

WebsiteList

Un elenco di siti web che hanno violato le norme.

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

string

Siti web che hanno causato la violazione delle norme.

DestinationTextList

Un elenco del testo della destinazione che ha violato le norme.

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

string

Testo della destinazione che ha causato la ricerca 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 degli 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] significa che l'URL finale dell'annuncio non corrisponde all'URL sottoposto a scansione, il che è considerato anche mancata corrispondenza della destinazione.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Tipi di URL possibili.

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 dell'annuncio.

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

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

string

L'URL completo che non ha funzionato.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Il dispositivo in cui la visita dell'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 normalizzato in base al fuso orario UTC 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".
Campo unione reason. Errore HTTP o DNS. reason può essere solo uno dei seguenti:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Il tipo di errore DNS.
httpErrorCode

string (int64 format)

Il codice di errore HTTP.

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 dell'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 del marchio 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 corrispondente al 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)

ID criterio paese.
countryLabel

string

Nome localizzato del paese. Può essere vuoto.

LegalRemoval

Applicazione di regolamenti correlati a questioni legali, ai sensi del DMCA o di regolamenti legali locali.

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

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
Campi
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

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

object (AdPolicyCriterionRestriction)

I paesi con limitazioni dovute alla rimozione per motivi legali.
restrictedUris[]

string

Gli URL limitati a causa della rimozione per motivi legali.
Campo unione type. Dettagli sul tipo di rimozione per motivi legali. type può essere solo uno dei seguenti:
dmca

object (Dmca)

Dettagli sulla rimozione per motivi legali ai sensi del regolamento DMCA.

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 reclami per la rimozione per motivi legali.

Enum
COPYRIGHT

Copyright.

Si applica solo al DMCA.
COURT_ORDER

Ingiunzione del tribunale.

Si applica solo alle questioni legali 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 di Trust & Safety (T&S) per le norme destinate a soddisfare i requisiti regionali. Poiché si tratta di un'applicazione proattiva dei Termini e Servizi, questa viene considerata un'indagine di proprietà di Google anziché una notifica di regolamento.

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

object (RegionalRequirementsEntry)

Elenco dei requisiti regionali.

RegionalRequirementsEntry

Dettagli delle violazioni legali regionali a livello di policy.

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

string

Le norme legali che vengono violate.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

I paesi con limitazioni dovute alle norme legali.

AdPolicyTopicConstraint

Dettagli sui vincoli di pubblicazione degli annunci.

Rappresentazione JSON 
{
  "requestCertificateFormLink": string,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
Campi
Campo unione constraint. Il vincolo di pubblicazione. constraint può essere solo uno dei seguenti:
countryConstraint

object (AdPolicyCountryConstraintList)

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

object (AdPolicyResellerConstraint)

Limitazione del rivenditore.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Paesi in cui è richiesta una certificazione per la pubblicazione.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

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

object (AdPolicyGlobalCertificateMissingConstraint)

Il certificato è obbligatorio per la pubblicazione in qualsiasi paese.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

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

AdPolicyCountryConstraintList

Un elenco di paesi in cui l'annuncio non può essere pubblicato a causa di limitazioni delle norme.

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

object (AdPolicyCriterionRestriction)

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

AdPolicyResellerConstraint

Questo tipo non contiene campi.

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

AdPolicyGlobalCertificateMissingConstraint

Questo tipo non contiene campi.

Il certificato è obbligatorio per la pubblicazione in qualsiasi paese.

AdPolicyGlobalCertificateDomainMismatchConstraint

Questo tipo non contiene campi.

Il certificato è obbligatorio per la pubblicazione in qualsiasi paese e il certificato 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 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.

DisplayVideoSourceAd

L'annuncio proviene da una creatività DV360.

Rappresentazione JSON 
{
  "creativeId": string
}
Campi
creativeId

string (int64 format)

L'ID della creatività di origine.

MastheadAd

Dettagli 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 il video inizierà la riproduzione.
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 di invito all'azione.
callToActionFinalUrl

string

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

string

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

boolean

Se mostrare uno sfondo o un banner 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)
}
Campi
id

string

L'ID video di YouTube, che può essere cercato nella pagina web di YouTube.
unavailableReason

enum (VideoUnavailableReason)

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

VideoUnavailableReason

Possibili motivi per cui un video potrebbe non essere disponibile.

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

VideoAspectRatio

Possibili formati per un video di YouTube.

Enum
VIDEO_ASPECT_RATIO_UNSPECIFIED Non specificato o sconosciuto.
VIDEO_ASPECT_RATIO_WIDESCREEN Il video è allungato e la parte superiore e inferiore sono ritagliate.
VIDEO_ASPECT_RATIO_FIXED_16_9 Il video utilizza proporzioni fisse 16:9.

InStreamAd

Dettagli di un annuncio in-stream.

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

object (CommonInStreamAttribute)

Attributi annuncio comuni.
customParameters

map (key: string, value: string)

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

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

CommonInStreamAttribute

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

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

string

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

string

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

string

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

string

Il testo del pulsante di invito all'azione.
actionHeadline

string

Il titolo del banner di invito all'azione.
video

object (YoutubeVideoDetails)

Il video di YouTube dell'annuncio.
companionBanner

object (ImageAsset)

L'immagine visualizzata accanto all'annuncio video.

ImageAsset

Metadati di un asset immagine.

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

string

Tipo MIME dell'asset immagine.
fullSize

object (Dimensions)

Metadati per questa immagine nelle sue dimensioni originali.
fileSize

string (int64 format)

Dimensioni del file dell'asset immagine in byte.

NonSkippableAd

Dettagli di un annuncio non ignorabile.

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

object (CommonInStreamAttribute)

Attributi annuncio comuni.
customParameters

map (key: string, value: string)

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

Un oggetto contenente un elenco di 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)

Attributi annuncio comuni.

AudioAd

Dettagli di un annuncio audio.

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

string

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

string

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

string

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

object (YoutubeVideoDetails)

Il video 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 per l'annuncio.
video

object (YoutubeVideoDetails)

Il video di YouTube promosso dall'annuncio.
thumbnail

enum (Thumbnail)

L'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

Dettagli di un annuncio video sul rendimento.

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

string

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

string

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

string

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

string

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

string

L'elenco dei titoli singoli mostrati nel banner dell'invito all'azione.
descriptions[]

string

L'elenco delle descrizioni mostrate nel banner dell'invito all'azione.
displayUrlBreadcrumb1

string

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

string

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

string

Il dominio dell'URL di visualizzazione.
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

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

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

object (ImageAsset)

L'elenco dei banner companion utilizzati da questo annuncio.

AdUrl

URL aggiuntivi correlati all'annuncio, inclusi i beacon.

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

enum (AdUrlType)

Il tipo di URL annuncio.
url

string

Il valore 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 da pingare quando viene pubblicata un'impressione di una creatività.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Beacon per impressioni DCM espandibili. Al momento della pubblicazione, viene espanso in diversi beacon.
AD_URL_TYPE_BEACON_CLICK URL di monitoraggio da pingare quando viene attivato l'evento relativo ai clic.
AD_URL_TYPE_BEACON_SKIP URL di monitoraggio da pingare quando viene attivato l'evento di salto.

Metodi

get

 Recupera un annuncio del gruppo di annunci.

list

 Elenca gli annunci del gruppo di annunci.