The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
UserData
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Son los datos que identifican al usuario. Se requiere al menos un identificador.
Representación JSON |
{
"userIdentifiers": [
{
object (UserIdentifier )
}
]
} |
Campos |
userIdentifiers[] |
object (UserIdentifier )
Obligatorio. Son los identificadores del usuario. Es posible proporcionar varias instancias del mismo tipo de datos (por ejemplo, varias direcciones de correo electrónico). Para aumentar las probabilidades de obtener una coincidencia, proporciona la mayor cantidad posible de identificadores. Se pueden proporcionar hasta 10 userIdentifiers en un solo AudienceMember o Event .
|
UserIdentifier
Es un identificador único para el usuario.
Representación 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 .
} |
Campos |
Campo de unión identifier . Se debe especificar exactamente uno. Las direcciones (identifier ) solo pueden ser una de las siguientes opciones: |
emailAddress |
string
Dirección de correo electrónico con codificación hash que utiliza la función hash SHA-256 después de la normalización.
|
phoneNumber |
string
Número de teléfono con codificación hash a través de la función hash SHA-256 después de la normalización (estándar E164).
|
address |
object (AddressInfo )
Son los componentes conocidos de la dirección de un usuario. Contiene una agrupación de identificadores que se correlacionan todos a la vez.
|
AddressInfo
Es la información de la dirección del usuario.
Representación JSON |
{
"givenName": string,
"familyName": string,
"regionCode": string,
"postalCode": string
} |
Campos |
givenName |
string
Obligatorio. Nombre (primero) del usuario, todo en minúsculas, sin signos de puntuación, sin espacios en blanco iniciales o finales, y con codificación hash como SHA-256.
|
familyName |
string
Obligatorio. Apellido del usuario, todo en minúsculas, sin signos de puntuación, sin espacios en blanco iniciales o finales, y con codificación hash como SHA-256.
|
regionCode |
string
Obligatorio. Es el código de región de 2 letras en ISO-3166-1 alpha-2 de la dirección del usuario.
|
postalCode |
string
Obligatorio. Es el código postal de la dirección del usuario.
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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. |"]]