The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
UserData
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Daten, die den Nutzer identifizieren. Mindestens eine Kennung ist erforderlich.
JSON-Darstellung |
{
"userIdentifiers": [
{
object (UserIdentifier )
}
]
} |
Felder |
userIdentifiers[] |
object (UserIdentifier )
Erforderlich. Die Kennungen für den Nutzer. Es ist möglich, mehrere Instanzen desselben Datentyps anzugeben, z. B. mehrere E-Mail-Adressen. Geben Sie so viele Kennungen wie möglich an, um die Wahrscheinlichkeit einer Übereinstimmung zu erhöhen. In einem einzelnen AudienceMember oder Event können maximal 10 userIdentifiers angegeben werden.
|
UserIdentifier
Eine einzelne Kennung für den Nutzer.
JSON-Darstellung |
{
// 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 .
} |
Felder |
Union-Feld identifier . Es muss genau eine angegeben werden. Für identifier ist nur einer der folgenden Werte zulässig: |
emailAddress |
string
Gehashte E-Mail-Adresse mit der SHA-256-Hash-Funktion nach der Normalisierung.
|
phoneNumber |
string
Gehashte Telefonnummer mit der SHA-256-Hash-Funktion nach der Normalisierung (E164-Standard).
|
address |
object (AddressInfo )
Die bekannten Komponenten der Adresse eines Nutzers. Enthält eine Gruppierung von Kennungen, die alle gleichzeitig abgeglichen werden.
|
AddressInfo
Adressinformationen für den Nutzer.
JSON-Darstellung |
{
"givenName": string,
"familyName": string,
"regionCode": string,
"postalCode": string
} |
Felder |
givenName |
string
Erforderlich. Vorname des Nutzers, nur Kleinbuchstaben, ohne Satzzeichen, ohne führende oder nachfolgende Leerzeichen und mit SHA-256 gehasht.
|
familyName |
string
Erforderlich. Nachname des Nutzers, alles in Kleinbuchstaben, ohne Satzzeichen, ohne führende oder nachfolgende Leerzeichen und mit SHA-256 gehasht.
|
regionCode |
string
Erforderlich. Der aus zwei Buchstaben bestehende Regionscode nach ISO 3166-1 Alpha 2 der Adresse des Nutzers.
|
postalCode |
string
Erforderlich. Die Postleitzahl der Adresse des Nutzers.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]