Package google.ads.datamanager.v1

string

Facoltativo. Attributi sessione per l'attribuzione e la modellazione degli eventi.

string

Facoltativo. L'ID clic Google (gclid) associato a questo evento.

string

Facoltativo. L'identificatore dei clic associati agli eventi app e provenienti da dispositivi iOS a partire da iOS 14.

string

Facoltativo. L'identificatore dei clic associati agli eventi web e provenienti da dispositivi iOS a partire da iOS 14.

DeviceInfo

Facoltativo. Informazioni raccolte sul dispositivo utilizzato (se presente) al momento dell'arrivo sul sito dell'inserzionista dopo l'interazione con l'annuncio.

string

Obbligatorio. Nome (di battesimo) dell'utente, tutto in minuscolo, senza punteggiatura, senza spazi iniziali o finali e sottoposto ad hashing come SHA-256.

string

Obbligatorio. Cognome dell'utente, tutto in minuscolo, senza punteggiatura, senza spazi iniziali o finali e sottoposto ad hashing come SHA-256.

string

Obbligatorio. Il codice regione di due lettere nel formato ISO-3166-1 alpha-2 dell'indirizzo dell'utente.

string

Obbligatorio. Il codice postale dell'indirizzo dell'utente.

string

Facoltativo. Definisce a quale Destination inviare il membro del segmento di pubblico.

Consent

Facoltativo. L'impostazione del consenso per l'utente.

UserData

Dati forniti dall'utente che lo identificano.

PairData

ID Publisher Advertiser Identity Reconciliation (PAIR).

Questa funzionalità è disponibile solo per i partner di dati.

MobileData

Dati che identificano i dispositivi mobili dell'utente.

UserIdData

Dati relativi agli identificatori unici per un utente, come definiti dall'inserzionista.

PpidData

Dati relativi agli identificatori forniti dal publisher.

Questa funzionalità è disponibile solo per i partner di dati.

KeyType

Obbligatorio. Il tipo di algoritmo utilizzato per criptare i dati.

string

Obbligatorio. L'Amazon Resource Name del ruolo IAM da utilizzare per l'accesso alla decrittografia KMS. Deve essere nel formato arn:{partition}:iam::{account_id}:role/{role_name}

string

Obbligatorio. L'URI della chiave AWS KMS utilizzata per decriptare la DEK. Deve essere nel formato arn:{partition}:kms:{region}:{account_id}:key/{key_id} o aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id}

string

Obbligatorio. La chiave di crittografia dei dati criptati con codifica base64.

Location

La posizione di base della richiesta. La posizione di base è un elenco OR delle regioni richieste.

bool

Se impostato su true, il servizio tenterà di rilevare automaticamente la posizione di base per gli approfondimenti.

string

Elenco dei codici regione ISO 3166-1 alpha-2.

string

Facoltativo. L'ID Merchant Center associato agli articoli.

string

Facoltativo. L'etichetta del feed di Merchant Center associata al feed degli articoli.

string

Facoltativo. Il codice lingua ISO 639-1 associato al feed Merchant Center degli articoli in cui vengono caricati i tuoi articoli.

double

Facoltativo. La somma di tutti gli sconti associati alla transazione.

Item

Facoltativo. L'elenco degli elementi associati all'evento.

ConsentStatus

Facoltativo. Indica se l'utente acconsente all'utilizzo dei dati utente per la pubblicità.

ConsentStatus

Facoltativo. Indica se l'utente acconsente alla personalizzazione degli annunci.

int32

Solo output. Tasso di corrispondenza per gli elenchi utenti Customer Match.

DataSourceType

Facoltativo. Immutabile. Origine dei dati di caricamento

string

Obbligatorio. L'elemento principale, proprietario di questa raccolta di link dei partner. Formato: accountTypes/{account_type}/accounts/{account}

PartnerLink

Obbligatorio. Il link del partner da creare.

string

Obbligatorio. L'account proprietario dell'elenco utenti per cui viene concessa la licenza. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

UserListDirectLicense

Obbligatorio. L'elenco degli utenti a cui assegnare la licenza diretta da creare.

string

Obbligatorio. L'account proprietario dell'elenco utenti per cui viene concessa la licenza. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

UserListGlobalLicense

Obbligatorio. La licenza globale per la creazione dell'elenco utenti.

string

Obbligatorio. L'account genitore in cui verrà creato questo elenco di utenti. Formato: accountTypes/{account_type}/accounts/{account}

UserList

Obbligatorio. L'elenco di utenti da creare.

bool

Facoltativo. Se impostato su true, la richiesta viene convalidata, ma non eseguita.

string

Facoltativo. Il nome della variabile personalizzata da impostare. Se la variabile non viene trovata per la destinazione specificata, verrà ignorata.

string

Facoltativo. Il valore da memorizzare per la variabile personalizzata.

string

Facoltativo. Stringa di riferimento utilizzata per determinare a quale dei Event.destination_references deve essere inviata la variabile personalizzata. Se il campo è vuoto, verrà utilizzato Event.destination_references.

string

Obbligatorio. Il nome della risorsa del link del partner da eliminare. Formato: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

Obbligatorio. Il nome dell'elenco di utenti da eliminare. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

bool

Facoltativo. Se impostato su true, la richiesta viene convalidata, ma non eseguita.

string

Facoltativo. ID per questa risorsa Destination, univoco all'interno della richiesta. Utilizza questo valore per fare riferimento a Destination in IngestEventsRequest e IngestAudienceMembersRequest.

ProductAccount

Facoltativo. L'account utilizzato per effettuare questa chiamata API. Per aggiungere o rimuovere dati da operating_account, questo login_account deve disporre dell'accesso in scrittura a operating_account. Ad esempio, un account amministratore di operating_account o un account con un collegamento stabilito a operating_account.

ProductAccount

Facoltativo. Un account a cui il login_account dell'utente chiamante ha accesso tramite un collegamento dell'account stabilito. Ad esempio, il login_account di un partner di dati potrebbe avere accesso al linked_account di un cliente. Il partner potrebbe utilizzare questo campo per inviare dati da linked_account a un altro operating_account.

ProductAccount

Obbligatorio. L'account a cui inviare i dati o da cui rimuoverli.

string

Obbligatorio. L'oggetto all'interno dell'account prodotto in cui eseguire l'importazione. Ad esempio, un ID segmento di pubblico Google Ads, un ID segmento di pubblico Display & Video 360 o un ID azione di conversione Google Ads.

string

Facoltativo. La stringa user agent del dispositivo per il contesto specificato.

string

Facoltativo. L'indirizzo IP del dispositivo per il contesto specificato.

Nota:Google Ads non supporta la corrispondenza degli indirizzi IP per gli utenti finali nello Spazio economico europeo (SEE), nel Regno Unito (UK) o in Svizzera (CH). Aggiungi una logica per escludere in modo condizionale la condivisione degli indirizzi IP degli utenti di queste regioni e assicurati di fornire agli utenti informazioni chiare e complete sui dati raccolti sui tuoi siti, nelle tue app e in altre proprietà e di ottenere il consenso ove richiesto dalla legge o da eventuali norme di Google vigenti. Per ulteriori dettagli, consulta la pagina Informazioni sulle importazioni delle conversioni offline.

GcpWrappedKeyInfo

Informazioni sulla chiave di wrapping di Google Cloud.

AwsWrappedKeyInfo

Informazioni sulla chiave con wrapping di Amazon Web Services.

int64

Il conteggio dei record che non sono stati caricati per un determinato motivo.

ProcessingErrorReason

Il motivo dell'errore dei record non riusciti.

ErrorCount

Un elenco di errori e conteggi per motivo dell'errore. Potrebbe non essere compilato in tutti i casi.

string

Facoltativo. Stringa di riferimento utilizzata per determinare la destinazione. Se è vuoto, l'evento verrà inviato a tutti i destinations nella richiesta.

string

Facoltativo. L'identificatore univoco di questo evento. Obbligatorio per le conversioni che utilizzano più origini dati.

Timestamp

Obbligatorio. L'ora in cui si è verificato l'evento.

Timestamp

Facoltativo. L'ultima volta che l'evento è stato aggiornato.

UserData

Facoltativo. Parti di dati forniti dall'utente, che rappresentano l'utente a cui è associato l'evento.

Consent

Facoltativo. Informazioni sul fatto che l'utente associato abbia fornito diversi tipi di consenso.

AdIdentifiers

Facoltativo. Identificatori e altre informazioni utilizzate per abbinare l'evento di conversione ad altre attività online (ad esempio clic sugli annunci).

string

Facoltativo. Il codice valuta associato a tutti i valori monetari all'interno di questo evento.

EventSource

Facoltativo. Indicatore del luogo in cui si è verificato l'evento (web, app, negozio fisico e così via).

DeviceInfo

Facoltativo. Informazioni raccolte sul dispositivo utilizzato (se presente) al momento dell'evento.

CartData

Facoltativo. Informazioni sulla transazione e sugli articoli associati all'evento.

CustomVariable

Facoltativo. Informazioni aggiuntive sulle coppie chiave/valore da inviare ai contenitori di conversione (azione di conversione o attività Floodlight).

ExperimentalField

Facoltativo. Un elenco di coppie chiave/valore per i campi sperimentali che potrebbero essere promossi per far parte dell'API.

UserProperties

Facoltativo. Informazioni valutate dall'inserzionista sull'utente al momento dell'evento.

string

Facoltativo. Il nome dell'evento. Obbligatorio per gli eventi GA4.

string

Facoltativo. Un identificatore univoco per l'istanza utente di un client web per questo stream web GA4.

string

Facoltativo. Un identificatore univoco per un utente, come definito dall'inserzionista.

EventParameter

Facoltativo. Un bucket di parametri evento da includere nell'evento che non sono già stati specificati utilizzando altri campi strutturati.

double

Facoltativo. Il valore di conversione associato all'evento, per le conversioni basate sul valore.

string

Obbligatorio. Il nome del parametro da utilizzare.

string

Obbligatorio. La rappresentazione stringa del valore del parametro da impostare.

string

Facoltativo. Il nome del campo da utilizzare.

string

Facoltativo. Il valore del campo da impostare.

KeyType

Obbligatorio. Il tipo di algoritmo utilizzato per criptare i dati.

string

Obbligatorio. Il provider di pool Workload Identity richiesto per utilizzare la KEK.

string

Obbligatorio. ID risorsa Cloud Key Management Service della piattaforma Google Cloud. Deve essere nel formato projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} o gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}

string

Obbligatorio. La chiave di crittografia dei dati criptati con codifica base64.

string

Obbligatorio. Il nome risorsa della licenza diretta dell'elenco utenti.

string

Obbligatorio. Il nome risorsa della licenza globale dell'elenco utenti.

string

Obbligatorio. Il nome della risorsa UserList da recuperare. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

Destination

Obbligatorio. L'elenco delle destinazioni a cui inviare i membri del segmento di pubblico.

AudienceMember

Obbligatorio. L'elenco degli utenti da inviare alle destinazioni specificate. In una singola richiesta possono essere inviate al massimo 10.000 risorse AudienceMember.

Consent

Facoltativo. Consenso a livello di richiesta da applicare a tutti gli utenti della richiesta. Il consenso a livello di utente sostituisce il consenso a livello di richiesta e può essere specificato in ogni AudienceMember.

bool

Facoltativo. A scopo di test. Se true, la richiesta viene convalidata, ma non eseguita. Vengono restituiti solo gli errori, non i risultati.

Encoding

Facoltativo. Obbligatorio per i caricamenti di UserData. Il tipo di codifica degli identificatori utente. Per gli identificatori utente sottoposti ad hashing, questo è il tipo di codifica della stringa sottoposta ad hashing. Per gli identificatori utente sottoposti ad hashing criptato, questo è il tipo di codifica della stringa criptata esterna, ma non necessariamente della stringa sottoposta ad hashing interna, il che significa che la stringa sottoposta ad hashing interna potrebbe essere codificata in modo diverso rispetto alla stringa criptata esterna. Per i caricamenti non UserData, questo campo viene ignorato.

EncryptionInfo

Facoltativo. Informazioni sulla crittografia per i caricamenti di UserData. Se non è impostato, si presume che le informazioni identificative caricate siano sottoposte ad hashing, ma non criptate. Per i caricamenti non UserData, questo campo viene ignorato.

TermsOfService

Facoltativo. I Termini di servizio che l'utente ha accettato/rifiutato.

string

L'ID generato automaticamente della richiesta.

Destination

Obbligatorio. L'elenco delle destinazioni a cui inviare gli eventi.

Event

Obbligatorio. L'elenco degli eventi da inviare alle destinazioni specificate. In una singola richiesta possono essere inviate al massimo 2000 risorse Event.

Consent

Facoltativo. Consenso a livello di richiesta da applicare a tutti gli utenti della richiesta. Il consenso a livello di utente sostituisce il consenso a livello di richiesta e può essere specificato in ogni Event.

bool

Facoltativo. A scopo di test. Se true, la richiesta viene convalidata, ma non eseguita. Vengono restituiti solo gli errori, non i risultati.

Encoding

Facoltativo. Obbligatorio per i caricamenti di UserData. Il tipo di codifica degli identificatori utente. Per gli identificatori utente sottoposti ad hashing, questo è il tipo di codifica della stringa sottoposta ad hashing. Per gli identificatori utente sottoposti ad hashing criptato, questo è il tipo di codifica della stringa criptata esterna, ma non necessariamente della stringa sottoposta ad hashing interna, il che significa che la stringa sottoposta ad hashing interna potrebbe essere codificata in modo diverso rispetto alla stringa criptata esterna. Per i caricamenti non UserData, questo campo viene ignorato.

EncryptionInfo

Facoltativo. Informazioni sulla crittografia per i caricamenti di UserData. Se non è impostato, si presume che le informazioni identificative caricate siano sottoposte ad hashing, ma non criptate. Per i caricamenti non UserData, questo campo viene ignorato.

string

L'ID generato automaticamente della richiesta.

UploadKeyType

Obbligatorio. Immutabile. Tipi di chiavi di caricamento di questo elenco utenti.

ContactIdInfo

Facoltativo. Informazioni aggiuntive quando CONTACT_ID è uno dei upload_key_types.

MobileIdInfo

Facoltativo. Informazioni aggiuntive quando MOBILE_ID è uno dei upload_key_types.

UserIdInfo

Facoltativo. Informazioni aggiuntive quando USER_ID è uno dei upload_key_types.

PairIdInfo

Facoltativo. Informazioni aggiuntive quando PAIR_ID è uno dei upload_key_types.

Questa funzionalità è disponibile solo per i partner di dati.

PseudonymousIdInfo

Facoltativo. Ulteriori informazioni per PSEUDONYMOUS_ID è uno dei upload_key_types.

PartnerAudienceInfo

Facoltativo. Informazioni aggiuntive per i segmenti di pubblico dei partner.

Questa funzionalità è disponibile solo per i partner di dati.

string

Facoltativo. L'ID prodotto all'interno dell'account Merchant Center.

int64

Facoltativo. Il numero di questo elemento associato all'evento.

double

Facoltativo. Il prezzo unitario al netto di tasse, spese di spedizione ed eventuali sconti a livello di transazione.

string

Facoltativo. Un identificatore univoco per fare riferimento all'elemento.

ItemParameter

Facoltativo. Un bucket di parametri evento correlati a un elemento da includere nell'evento che non sono già stati specificati utilizzando altri campi strutturati.

string

Obbligatorio. Il nome del parametro da utilizzare.

string

Obbligatorio. La rappresentazione stringa del valore del parametro da impostare.

string

Obbligatorio. L'account le cui licenze sono oggetto della query. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

string

Facoltativo. Filtri da applicare alla richiesta di elenco. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio: user_list_id = 123).

Operazioni supportate:

• AND
• =
• !=
• >
• >=
• <
• <=

Campi non supportati:

• name (utilizza invece il metodo get)
• historical_pricings e tutti i relativi campi secondari
• pricing.start_time
• pricing.end_time

int32

Facoltativo. Il numero massimo di licenze da restituire per pagina. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non è specificato, verranno restituite al massimo 50 licenze. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListUserListDirectLicense. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListUserListDirectLicense devono corrispondere alla chiamata che ha fornito il token di pagina.

UserListDirectLicense

Le licenze per l'elenco utenti specificato nella richiesta.

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

string

Obbligatorio. La licenza globale di cui vengono richieste le informazioni sul cliente. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Per elencare tutte le informazioni sui clienti con licenza globale in un account, sostituisci l'ID licenza globale dell'elenco utenti con un trattino ("-", ad esempio accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

string

Facoltativo. Filtri da applicare alla richiesta di elenco. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio: user_list_id = 123).

Operazioni supportate:

• AND
• =
• !=
• >
• >=
• <
• <=

Campi non supportati:

• name (utilizza invece il metodo get)
• historical_pricings e tutti i relativi campi secondari
• pricing.start_time
• pricing.end_time

int32

Facoltativo. Il numero massimo di licenze da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non è specificato, verranno restituite al massimo 50 licenze. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListUserListDirectLicense. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListUserListDirectLicense devono corrispondere alla chiamata che ha fornito il token di pagina.

UserListGlobalLicenseCustomerInfo

Le informazioni sul cliente per la licenza specificata nella richiesta.

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

string

Obbligatorio. L'account le cui licenze sono oggetto della query. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}

string

Facoltativo. Filtri da applicare alla richiesta di elenco. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio: user_list_id = 123).

Operazioni supportate:

• AND
• =
• !=
• >
• >=
• <
• <=

Campi non supportati:

• name (utilizza invece il metodo get)
• historical_pricings e tutti i relativi campi secondari
• pricing.start_time
• pricing.end_time

int32

Facoltativo. Il numero massimo di licenze da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non è specificato, verranno restituite al massimo 50 licenze. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListUserListGlobalLicense. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListUserListDirectLicense devono corrispondere alla chiamata che ha fornito il token di pagina.

UserListGlobalLicense

Le licenze per l'elenco utenti specificato nella richiesta.

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

string

Obbligatorio. L'account genitore proprietario di questa raccolta di elenchi utenti. Formato: accountTypes/{account_type}/accounts/{account}

int32

Facoltativo. Il numero massimo di elenchi di utenti da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 50 elenchi di utenti. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListUserLists. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListUserLists devono corrispondere alla chiamata che ha fornito il token di pagina.

string

Facoltativo. Una stringa di filtro. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio, display_name = "list 1").

Operazioni supportate:

• AND
• =
• !=
• >
• >=
• <
• <=
• : (ha)

Campi supportati:

• id
• display_name
• description
• membership_status
• integration_code
• access_reason
• ingested_user_list_info.upload_key_types

UserList

Gli elenchi di utenti dell'account specificato.

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

string

Obbligatorio. L'elenco degli ID dispositivo mobile (ID pubblicità/IDFA). Possono essere forniti al massimo 10 mobileIds in un singolo AudienceMember.

DataSourceType

Facoltativo. Immutabile. Origine dei dati di caricamento.

KeySpace

Obbligatorio. Immutabile. Lo spazio delle chiavi degli ID mobile.

string

Obbligatorio. Immutabile. Una stringa che identifica in modo univoco un'applicazione mobile da cui sono stati raccolti i dati.

string

Obbligatorio. Dati PII forniti dalla data clean room, sottoposti ad hashing con SHA256 e criptati con una cifratura commutativa EC utilizzando la chiave del publisher per l'elenco utenti PAIR. Possono essere forniti al massimo 10 pairIds in un singolo AudienceMember.

int32

Solo output. Questo campo indica la percentuale di corrispondenza dell'inclusione di questo elenco utenti con i dati proprietari del publisher corrispondente. Deve essere compreso tra 0 e 100 inclusi.

int64

Solo output. Il conteggio dei record di dati proprietari dell'inserzionista caricati in un fornitore di data clean room. Ciò non indica le dimensioni di un elenco di utenti PAIR.

int64

Obbligatorio. Immutabile. Identifica l'editore con cui viene riconciliato l'elenco utenti Publisher Advertiser Identity Reconciliation. Questo campo è fornito dal fornitore della clean room ed è univoco solo nell'ambito di quella clean room. Non può essere utilizzato come identificatore globale in più cleanroom.

string

Facoltativo. Nome descrittivo del publisher da visualizzare nell'interfaccia utente per una migliore esperienza di targeting.

string

Obbligatorio. Immutabile. Identifica una relazione univoca tra inserzionista e publisher con un fornitore di data clean room o con più fornitori.

PartnerAudienceSource

Obbligatorio. Immutabile. L'origine del segmento di pubblico partner.

string

Facoltativo. Il nome del partner commerciale. Consentito solo se partner_audience_source è COMMERCE_AUDIENCE.

string

Identificatore. Il nome del link del partner. Formato: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

string

Solo output. L'ID link partner.

ProductAccount

Obbligatorio. L'account proprietario che concede l'accesso all'account partner.

ProductAccount

Obbligatorio. L'account partner a cui è stato concesso l'accesso dall'account proprietario.

string

Obbligatorio. L'elenco degli identificatori forniti dal publisher per un utente.

Product

Deprecato. Utilizza invece account_type.

string

Obbligatorio. L'ID dell'account. Ad esempio, l'ID account Google Ads.

AccountType

Facoltativo. Il tipo di account. Ad esempio, GOOGLE_ADS. È obbligatorio specificare account_type o product (deprecato). Se entrambi sono impostati, i valori devono corrispondere.

SyncStatus

Solo output. Stato della sincronizzazione dell'elenco utenti.

int64

Facoltativo. Immutabile. Il numero di record fatturabili (ad es. caricati o corrispondenti).

Destination

Obbligatorio. L'elenco delle destinazioni da cui rimuovere gli utenti.

AudienceMember

Obbligatorio. L'elenco degli utenti da rimuovere.

bool

Facoltativo. A scopo di test. Se true, la richiesta viene convalidata, ma non eseguita. Vengono restituiti solo gli errori, non i risultati.

Encoding

Facoltativo. Obbligatorio per i caricamenti di UserData. Il tipo di codifica degli identificatori utente. Si applica solo alla codifica esterna degli identificatori utente criptati. Per i caricamenti non UserData, questo campo viene ignorato.

EncryptionInfo

Facoltativo. Informazioni sulla crittografia per i caricamenti di UserData. Se non è impostato, si presume che le informazioni identificative caricate siano sottoposte ad hashing, ma non criptate. Per i caricamenti non UserData, questo campo viene ignorato.

string

L'ID generato automaticamente della richiesta.

Destination

Una destinazione all'interno di una richiesta API DM.

RequestStatus

Lo stato della richiesta della destinazione.

ErrorInfo

Un errore di informazioni sull'errore contenente il motivo e i conteggi degli errori relativi al caricamento.

WarningInfo

Informazioni di avviso contenenti il motivo dell'avviso e i conteggi degli avvisi relativi al caricamento.

IngestAudienceMembersStatus

Lo stato della richiesta di inserimento dei membri del segmento di pubblico.

IngestEventsStatus

Lo stato della richiesta di eventi di importazione.

RemoveAudienceMembersStatus

Lo stato della richiesta di rimozione dei membri del segmento di pubblico.

IngestUserDataStatus

Lo stato dell'importazione dei dati utente nella destinazione.

IngestMobileDataStatus

Lo stato dell'importazione dei dati mobili nella destinazione.

IngestPairDataStatus

Lo stato dell'importazione dei dati della coppia nella destinazione.

IngestUserIdDataStatus

Lo stato dell'importazione dei dati dell'ID utente nella destinazione.

IngestPpidDataStatus

Lo stato dell'importazione dei dati PPID nella destinazione.

int64

Il conteggio totale degli eventi inviati nella richiesta di caricamento. Include tutti gli eventi nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

int64

Il conteggio totale degli ID dispositivo mobile inviati nella richiesta di caricamento per la destinazione. Include tutti gli ID mobile nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

int64

Il conteggio totale degli ID coppia inviati nella richiesta di caricamento per la destinazione. Include tutti gli ID coppia nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

int64

Il conteggio totale degli ID pubblicità inviati nella richiesta di caricamento per la destinazione. Include tutti gli ID pubblicità personale nella richiesta, indipendentemente dal fatto che siano stati importati correttamente o meno.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

int64

Il conteggio totale degli identificatori utente inviati nella richiesta di caricamento per la destinazione. Include tutti gli identificatori utente nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

MatchRateRange

L'intervallo del tasso di corrispondenza del caricamento.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

int64

Il conteggio totale degli ID utente inviati nella richiesta di caricamento per la destinazione. Include tutti gli ID utente nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno.

RemoveUserDataStatus

Lo stato della rimozione dei dati utente dalla destinazione.

RemoveMobileDataStatus

Lo stato della rimozione dei dati mobili dalla destinazione.

RemovePairDataStatus

Lo stato della rimozione dei dati della coppia dalla destinazione.

RemoveUserIdDataStatus

Lo stato della rimozione dei dati dello User-ID dalla destinazione.

RemovePpidDataStatus

Lo stato della rimozione dei dati PPID dalla destinazione.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno.

int64

Il conteggio totale degli ID dispositivo mobile inviati nella richiesta di rimozione. Include tutti gli ID mobile nella richiesta, indipendentemente dal fatto che siano stati rimossi o meno.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno.

int64

Il conteggio totale degli ID coppia inviati nella richiesta di rimozione. Include tutti gli ID coppia nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno.

int64

Il conteggio totale degli ID pubblicità inviati nella richiesta di rimozione. Include tutti gli ID pubblicità nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno.

int64

Il conteggio totale degli identificatori utente inviati nella richiesta di rimozione. Include tutti gli identificatori utente nella richiesta, indipendentemente dal fatto che siano stati rimossi o meno.

int64

Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno.

int64

Il conteggio totale degli ID utente inviati nella richiesta di rimozione. Include tutti gli ID utente nella richiesta, indipendentemente dal fatto che siano stati rimossi o meno.

string

Obbligatorio. L'account genitore proprietario dell'elenco utenti. Formato: accountTypes/{account_type}/accounts/{account}

Baseline

Obbligatorio. Il valore di base per gli approfondimenti richiesti.

string

Obbligatorio. L'ID elenco utenti per cui vengono richieste informazioni.

MarketingDataInsight

Contiene gli approfondimenti sui dati di marketing.

AudienceInsightsDimension

La dimensione a cui appartiene l'approfondimento.

MarketingDataInsightsAttribute

Approfondimenti per i valori di una determinata dimensione.

int64

L'ID dell'interesse dell'utente.

float

Misura dell'incremento che il pubblico ha per il valore dell'attributo rispetto al valore di base. Intervallo [0-1].

AgeRange

La fascia d'età del pubblico per cui viene fornito il sollevamento.

Gender

Il genere del pubblico per cui viene fornito l'incremento.

string

Obbligatorio. Obbligatorio. L'ID richiesta della richiesta dell'API Data Manager.

RequestStatusPerDestination

Un elenco degli stati delle richieste per destinazione. L'ordine degli stati corrisponde all'ordine delle destinazioni nella richiesta originale.

string

Obbligatorio. Account in cui cercare i link partner. Se non viene specificato alcun filter, vengono restituiti tutti i link partner in cui questo account è owning_account o partner_account.

Formato: accountTypes/{account_type}/accounts/{account}

int32

Il numero massimo di link dei partner da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 10 link partner. Il valore massimo è 100; i valori superiori a 100 verranno forzati a 100.

string

Un token di pagina, ricevuto da una precedente chiamata SearchPartnerLinks. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a SearchPartnerLinks devono corrispondere alla chiamata che ha fornito il token di pagina.

string

Facoltativo. Una stringa di filtro. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio, partner_link_id = 123456789).

Operazioni supportate:

• AND
• =
• !=

Campi supportati:

• partner_link_id
• owning_account.account_type
• owning_account.account_id
• partner_account.account_type
• partner_account.account_id

Esempio: owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321

PartnerLink

I link partner per l'account specificato.

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

int64

Solo output. Numero stimato di membri di questo elenco utenti sulla Rete Display di Google.

int64

Solo output. Numero stimato di membri di questo elenco utenti nel dominio google.com. Questi sono i membri disponibili per il targeting nelle campagne sulla rete di ricerca.

bool

Solo output. Indica che questo elenco utenti è idoneo per la Rete Display di Google.

bool

Facoltativo. Indica se questo elenco di utenti è idoneo per la rete di ricerca Google.

TermsOfServiceStatus

Facoltativo. Termini di servizio di Customer Match: https://support.google.com/adspolicy/answer/6299717. Deve essere accettato durante l'importazione di UserData o MobileData. Questo campo non è obbligatorio per l'elenco utenti Partner Match.

UserListDirectLicense

Obbligatorio. Il campo name delle licenze viene utilizzato per identificare la licenza da aggiornare.

FieldMask

Facoltativo. L'elenco dei campi da aggiornare. Il carattere speciale * non è supportato e, se utilizzato, verrà generato un errore INVALID_UPDATE_MASK.

UserListGlobalLicense

Obbligatorio. Il campo name delle licenze viene utilizzato per identificare la licenza da aggiornare.

FieldMask

Facoltativo. L'elenco dei campi da aggiornare. Il carattere speciale * non è supportato e, se utilizzato, verrà generato un errore INVALID_UPDATE_MASK.

UserList

Obbligatorio. L'elenco utenti da aggiornare.

Il campo name dell'elenco utenti viene utilizzato per identificare l'elenco utenti da aggiornare. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

FieldMask

Facoltativo. L'elenco dei campi da aggiornare.

bool

Facoltativo. Se impostato su true, la richiesta viene convalidata, ma non eseguita.

UserIdentifier

Obbligatorio. Gli identificatori dell'utente. È possibile fornire più istanze dello stesso tipo di dati (ad esempio, più indirizzi email). Per aumentare la probabilità di una corrispondenza, fornisci il maggior numero possibile di identificatori. Possono essere forniti al massimo 10 userIdentifiers in un singolo AudienceMember o Event.

string

Obbligatorio. Un identificatore univoco per un utente, come definito dall'inserzionista.

DataSourceType

Facoltativo. Immutabile. Origine dei dati di caricamento.

string

Indirizzo email sottoposto ad hashing utilizzando la funzione hash SHA-256 dopo la normalizzazione.

string

Numero di telefono sottoposto ad hashing utilizzando la funzione hash SHA-256 dopo la normalizzazione (standard E164).

AddressInfo

I componenti noti dell'indirizzo di un utente. Contiene un raggruppamento di identificatori che vengono abbinati contemporaneamente.

string

Identificatore. Il nome risorsa dell'elenco utenti. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

int64

Solo output. L'ID univoco dell'elenco utenti.

bool

Solo output. Un'opzione che indica se un utente può modificare un elenco.

Duration

Facoltativo. La durata per cui un utente rimane nell'elenco utenti. Le durate valide sono multipli esatti di 24 ore (86.400 secondi). Se fornisci un valore che non è un multiplo esatto di 24 ore, verrà generato un errore INVALID_ARGUMENT.

AccessReason

Solo output. Il motivo per cui a questo account è stato concesso l'accesso all'elenco.

SizeInfo

Solo output. Numero stimato di membri di questo elenco di utenti in diverse reti di destinazione.

TargetNetworkInfo

Facoltativo. Informazioni sull'idoneità per diverse reti di destinazione.

string

Obbligatorio. Il nome visualizzato dell'elenco utenti.

string

Facoltativo. Una descrizione dell'elenco di utenti.

MembershipStatus

Facoltativo. Stato dell'abbonamento di questo elenco di utenti.

string

Facoltativo. Un ID del sistema esterno. Viene utilizzato dai venditori di elenchi di utenti per correlare gli ID sui loro sistemi.

ClosingReason

Solo output. Il motivo per cui lo stato di abbonamento a questo elenco di utenti è chiuso.

AccessStatus

Facoltativo. Indica se questa condivisione è ancora attiva. Quando un elenco di utenti viene condiviso con l'account, questo campo è impostato su ENABLED. In un secondo momento, il proprietario dell'elenco utenti può decidere di revocare la condivisione e renderla DISABLED.

IngestedUserListInfo

Facoltativo. Rappresenta un elenco utenti compilato con i dati inseriti dagli utenti.

string

Identificatore. Il nome risorsa della licenza diretta dell'elenco utenti.

string

Solo output. Nome dell'elenco utenti per cui viene concessa la licenza.

Questo campo è di sola lettura.

string

Solo output. Nome del cliente del cliente a cui viene concessa la licenza dell'elenco utenti.

Questo campo è di sola lettura.

UserListLicensePricing

Facoltativo. Prezzi di UserListDirectLicense.

UserListLicensePricing

Solo output. Cronologia dei prezzi di questa licenza per l'elenco di utenti.

Questo campo è di sola lettura.

UserListLicenseMetrics

Solo output. Metriche correlate a questa licenza

Questo campo è di sola lettura e viene compilato solo se le date di inizio e di fine sono impostate nella chiamata ListUserListDirectLicenses

int64

Immutabile. ID dell'elenco utenti per cui viene concessa la licenza.

UserListLicenseClientAccountType

Immutabile. Tipo di account del cliente a cui viene concessa la licenza per l'elenco utenti.

int64

Immutabile. ID del cliente cliente a cui viene concessa la licenza dell'elenco utenti.

UserListLicenseStatus

Facoltativo. Stato di UserListDirectLicense: ENABLED o DISABLED.

string

Identificatore. Il nome risorsa della licenza globale dell'elenco utenti.

string

Solo output. Nome dell'elenco utenti per cui viene concessa la licenza.

Questo campo è di sola lettura.

UserListLicensePricing

Facoltativo. Prezzi delle licenze globali UserList.

UserListLicensePricing

Solo output. Cronologia dei prezzi di questa licenza per l'elenco di utenti.

Questo campo è di sola lettura.

UserListLicenseMetrics

Solo output. Metriche correlate a questa licenza

Questo campo è di sola lettura e viene compilato solo se le date di inizio e di fine sono impostate nella chiamata ListUserListGlobalLicenses

int64

Immutabile. ID dell'elenco utenti per cui viene concessa la licenza.

UserListGlobalLicenseType

Immutabile. Tipo di prodotto del cliente a cui viene concessa la licenza dell'elenco utenti.

UserListLicenseStatus

Facoltativo. Stato di UserListGlobalLicense: ENABLED o DISABLED.

string

Identificatore. Il nome risorsa del cliente con licenza globale dell'elenco utenti.

int64

Solo output. ID dell'elenco utenti per cui viene concessa la licenza.

string

Solo output. Nome dell'elenco utenti per cui viene concessa la licenza.

UserListGlobalLicenseType

Solo output. Tipo di prodotto del cliente a cui viene concessa la licenza dell'elenco utenti.

UserListLicenseStatus

Solo output. Stato di UserListDirectLicense: ENABLED o DISABLED.

UserListLicensePricing

Solo output. Prezzi di UserListDirectLicense.

UserListLicenseClientAccountType

Solo output. Tipo di prodotto del cliente a cui viene concessa la licenza dell'elenco utenti.

int64

Solo output. ID del cliente cliente a cui viene concessa la licenza dell'elenco utenti.

string

Solo output. Nome del cliente del cliente a cui viene concessa la licenza dell'elenco utenti.

UserListLicensePricing

Solo output. Cronologia dei prezzi di questa licenza per l'elenco di utenti.

UserListLicenseMetrics

Solo output. Metriche correlate a questa licenza

Questo campo viene compilato solo se le date di inizio e fine sono impostate nella chiamata ListUserListGlobalLicenseCustomerInfos.

int64

Solo output. Il numero di clic per la licenza dell'elenco utenti.

int64

Solo output. Il numero di impressioni per la licenza dell'elenco utenti.

int64

Solo output. Le entrate per la licenza dell'elenco utenti in micro USD.

int64

Solo output. La data di inizio (inclusa) delle metriche nel formato AAAAMMGG. Ad esempio, 20260102 rappresenta il 2 gennaio 2026. Se end_date viene utilizzato nel filtro, è obbligatorio anche start_date. Se nel filtro non sono inclusi né start_date né end_date, i campi UserListLicenseMetrics non verranno compilati nella risposta.

int64

Solo output. La data di fine (inclusa) delle metriche nel formato AAAAMMGG. Ad esempio, 20260102 rappresenta il 2 gennaio 2026. Se start_date viene utilizzato nel filtro, è obbligatorio anche end_date. Se nel filtro non sono inclusi né start_date né end_date, i campi UserListLicenseMetrics non verranno compilati nella risposta.

int64

Solo output. L'ID di questo prezzo.

Timestamp

Solo output. Ora di inizio del prezzo.

Timestamp

Facoltativo. Ora di fine del prezzo.

bool

Solo output. Indica se questi prezzi sono attivi.

UserListPricingBuyerApprovalState

Solo output. Lo stato di approvazione dell'acquirente di questo prezzo.

Questo campo è di sola lettura.

int64

Facoltativo. Il costo associato al modello, in micro-unità (10^-6), nella valuta specificata dal campo currency_code. Ad esempio, 2000000 significa 2 $se currency_code è USD.

string

Facoltativo. La valuta in cui sono specificati costo e max_cost. Deve essere un codice valuta di tre lettere definito nello standard ISO 4217.

UserListPricingCostType

Immutabile. Il tipo di costo di questo prezzo.

Può essere impostato solo nell'operazione create. Non può essere aggiornato per una licenza esistente.

int64

Facoltativo. Il CPM massimo che può essere addebitato a un pubblico commerciale quando viene utilizzato il tipo di costo MEDIA_SHARE. Il valore è in micro unità (10^-6) e nella valuta specificata dal campo currency_code. Ad esempio, 2000000 significa 2 $se currency_code è USD.

Questo valore è pertinente solo quando cost_type è MEDIA_SHARE. Quando cost_type non è MEDIA_SHARE e questo campo è impostato, viene restituito un errore MAX_COST_NOT_ALLOWED. Se non viene impostato o viene impostato su 0, non è previsto alcun limite.

CustomerType

Facoltativo. Tipo di cliente associato all'evento.

CustomerValueBucket

Facoltativo. Il valore del cliente valutato dall'inserzionista.

UserProperty

Facoltativo. Un bucket di eventuali proprietà utente aggiuntive per l'utente associato a questo evento.

string

Obbligatorio. Il nome della proprietà utente da utilizzare.

string

Obbligatorio. La rappresentazione stringa del valore della proprietà utente da utilizzare.

int64

Il conteggio dei record che presentano un avviso.

ProcessingWarningReason

Il motivo dell'avviso.

WarningCount

Un elenco di avvisi e conteggi per motivo dell'avviso.