The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
UserData
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Dati che identificano l'utente. È richiesto almeno un identificatore.
| Rappresentazione JSON |
{
"userIdentifiers": [
{
object (UserIdentifier)
}
]
} |
| Campi |
userIdentifiers[] |
object (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.
|
UserIdentifier
Un unico identificatore per l'utente.
| Rappresentazione JSON |
{
// Union field identifier can be only one of the following:
"emailAddress": string,
"phoneNumber": string,
"address": {
object (AddressInfo)
}
// End of list of possible types for union field identifier.
} |
| Campi |
Campo unione identifier. Deve essere specificato esattamente un valore. identifier può essere solo uno dei seguenti: |
emailAddress |
string
Indirizzo email sottoposto ad hashing utilizzando la funzione hash SHA-256 dopo la normalizzazione.
|
phoneNumber |
string
Numero di telefono sottoposto ad hashing utilizzando la funzione hash SHA-256 dopo la normalizzazione (standard E164).
|
address |
object (AddressInfo)
I componenti noti dell'indirizzo di un utente. Contiene un raggruppamento di identificatori che vengono abbinati contemporaneamente.
|
AddressInfo
Informazioni sull'indirizzo dell'utente.
| Rappresentazione JSON |
{
"givenName": string,
"familyName": string,
"regionCode": string,
"postalCode": string
} |
| Campi |
givenName |
string
Obbligatorio. Nome (di battesimo) dell'utente, tutto in minuscolo, senza punteggiatura, senza spazi iniziali o finali e sottoposto ad hashing come SHA-256.
|
familyName |
string
Obbligatorio. Cognome dell'utente, tutto in minuscolo, senza punteggiatura, senza spazi iniziali o finali e sottoposto ad hashing come SHA-256.
|
regionCode |
string
Obbligatorio. Il codice regione di due lettere nel formato ISO-3166-1 alpha-2 dell'indirizzo dell'utente.
|
postalCode |
string
Obbligatorio. Il codice postale dell'indirizzo dell'utente.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# UserData\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [UserIdentifier](#UserIdentifier)\n - [JSON representation](#UserIdentifier.SCHEMA_REPRESENTATION)\n- [AddressInfo](#AddressInfo)\n - [JSON representation](#AddressInfo.SCHEMA_REPRESENTATION)\n\nData that identifies the user. At least one identifier is required.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------|\n| ``` { \"userIdentifiers\": [ { object (/data-manager/api/reference/rest/v1/UserData#UserIdentifier) } ] } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userIdentifiers[]` | `object (`[UserIdentifier](/data-manager/api/reference/rest/v1/UserData#UserIdentifier)`)` Required. The identifiers for the user. It's possible to provide multiple instances of the same type of data (for example, multiple email addresses). To increase the likelihood of a match, provide as many identifiers as possible. At most 10 `userIdentifiers` can be provided in a single [AudienceMember](/data-manager/api/reference/rest/v1/AudienceMember) or [Event](/data-manager/api/reference/rest/v1/events/ingest#Event). |\n\nUserIdentifier\n--------------\n\nA single identifier for the user.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { // Union field `identifier` can be only one of the following: \"emailAddress\": string, \"phoneNumber\": string, \"address\": { object (/data-manager/api/reference/rest/v1/UserData#AddressInfo) } // End of list of possible types for union field `identifier`. } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union field `identifier`. Exactly one must be specified. `identifier` can be only one of the following: ||\n| `emailAddress` | `string` Hashed email address using SHA-256 hash function after normalization. |\n| `phoneNumber` | `string` Hashed phone number using SHA-256 hash function after normalization (E164 standard). |\n| `address` | `object (`[AddressInfo](/data-manager/api/reference/rest/v1/UserData#AddressInfo)`)` The known components of a user's address. Holds a grouping of identifiers that are matched all at once. |\n\nAddressInfo\n-----------\n\nAddress information for the user.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------|\n| ``` { \"givenName\": string, \"familyName\": string, \"regionCode\": string, \"postalCode\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `givenName` | `string` Required. Given (first) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256. |\n| `familyName` | `string` Required. Family (last) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256. |\n| `regionCode` | `string` Required. The 2-letter region code in ISO-3166-1 alpha-2 of the user's address. |\n| `postalCode` | `string` Required. The postal code of the user's address. |"]]
