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

  // 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)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of list of possible types for union field ad_details.
}
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 codificata 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 degli URL utilizzati dall'annuncio.
dcmTrackingInfo

object (DcmTrackingInfo)

Facoltativo. Le informazioni sull'annuncio di monitoraggio DCM. Valide solo per gli annunci Demand Gen.

Per rimuovere le informazioni sull'annuncio di monitoraggio DCM, lascia vuoto questo campo.
Campo unione ad_details. I dettagli dell'annuncio. ad_details può essere solo uno dei seguenti tipi:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Solo output. Dettagli di un annuncio proveniente da una creatività 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 gli 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 gli 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 raggiungere gli obiettivi di marketing di copertura.
videoDiscoverAd

object (VideoDiscoveryAd)

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

object (VideoPerformanceAd)

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

object (DemandGenVideoAd)

Dettagli di un annuncio video Demand Gen.
demandGenImageAd

object (DemandGenImageAd)

Dettagli di un annuncio illustrato Demand Gen.
demandGenProductAd

object (DemandGenProductAd)

Dettagli di un annuncio di prodotto Demand Gen.

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à erogato.
APPROVED_LIMITED Verrà erogato 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 corso 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 alle norme relative 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.

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

string

Testo dell'etichetta localizzato per le norme.

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

string

Un breve riepilogo dell'argomento delle norme.
policyTopicType

enum (AdPolicyTopicEntryType)

In che modo la pubblicazione di annunci sarà interessata a causa della relazione con l'argomento delle norme relative agli annunci.
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 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 utile 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 tipi:
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 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 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 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.

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

I siti web che hanno causato il risultato 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 il risultato 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] indica 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 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".
Campo unione reason. Errore HTTP o DNS. reason può essere solo uno dei seguenti tipi:
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 tipi:
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 limitati a causa delle 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 tipi:
countryConstraint

object (AdPolicyCountryConstraintList)

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

object (AdPolicyResellerConstraint)

Vincolo 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 vincoli 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 di ricorso.

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),
  "videoAssetId": string
}
Campi
id

string

Solo output. 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.
videoAssetId

string (int64 format)

Obbligatorio. L'ID risorsa 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 è stato eliminato.

VideoAspectRatio

Proporzioni possibili 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 un formato fisso 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 e i valori corrispondenti 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 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,
  "assetId": string
}
Campi
mimeType

string

Solo output. Tipo MIME dell'asset immagine.
fullSize

object (Dimensions)

Solo output. Metadati per questa immagine nelle sue 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

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 e i valori corrispondenti 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)

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 sul rendimento del video.

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 lunghi 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 e i valori corrispondenti 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)

L'elenco dei banner companion utilizzati da questo annuncio.

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

string

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

enum (CallToAction)

Obbligatorio. Il pulsante di invito all'azione 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 corrispondenti 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

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

CallToAction

Valori possibili dell'invito all'azione per gli annunci video/di prodotto 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 a scopo di monitoraggio.
userSpecifiedTrackingUrl

string

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

string

Obbligatorio. Il pulsante di invito all'azione 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 corrispondenti 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

Obbligatorio. Il nome dell'attività mostrato nell'annuncio.
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 marketing verticali mostrate nell'annuncio.
logoImages[]

object (ImageAsset)

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

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

string

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

string

Obbligatorio. Il nome dell'attività mostrato nell'annuncio.
customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori corrispondenti 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 di invito all'azione mostrato sulla scheda.

Deve contenere massimo 10 caratteri.
marketingImage

object (ImageAsset)

Facoltativo. L'immagine marketing mostrata sulla scheda.
squareMarketingImage

object (ImageAsset)

Facoltativo. L'immagine marketing quadrata mostrata sulla scheda.
portraitMarketingImage

object (ImageAsset)

Facoltativo. L'immagine marketing verticale mostrata sulla 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 di invito all'azione 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 a scopo di monitoraggio.
userSpecifiedTrackingUrl

string

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

string

Obbligatorio. Il nome dell'attività mostrato nell'annuncio.
customParameters

map (key: string, value: string)

Facoltativo. I parametri personalizzati e i valori corrispondenti 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.

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 di clic.
AD_URL_TYPE_BEACON_SKIP URL di monitoraggio da pingare 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.