The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
UserData
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
נתונים שמזהים את המשתמש. צריך לציין לפחות מזהה אחד.
| שדות |
userIdentifiers[] |
object (UserIdentifier)
חובה. המזהים של המשתמש. אפשר לספק כמה מקרים של אותו סוג נתונים (לדוגמה, כמה כתובות אימייל). כדי להגדיל את הסיכוי להתאמה, כדאי לספק כמה שיותר מזהים. אפשר לספק עד 10 userIdentifiers בקובץ AudienceMember או Event אחד.
|
UserIdentifier
| ייצוג ב-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.
} |
| שדות |
שדה איחוד identifier. חובה לציין בדיוק אחד מהם. הערך identifier יכול להיות רק אחד מהבאים: |
emailAddress |
string
כתובת אימייל שעברה גיבוב באמצעות פונקציית הגיבוב SHA-256 אחרי נרמול.
|
phoneNumber |
string
מספר טלפון שעבר גיבוב באמצעות פונקציית הגיבוב SHA-256 אחרי נרמול (תקן E164).
|
address |
object (AddressInfo)
הרכיבים הידועים של כתובת המשתמש. מכיל קיבוץ של מזהים שתואמים בבת אחת.
|
AddressInfo
| ייצוג ב-JSON |
{
"givenName": string,
"familyName": string,
"regionCode": string,
"postalCode": string
} |
| שדות |
givenName |
string
חובה. השם (הפרטי) של המשתמש, באותיות קטנות, ללא סימני פיסוק, ללא רווחים מובילים או נגררים, ועבר גיבוב לפי תקן SHA-256.
|
familyName |
string
חובה. שם המשפחה של המשתמש, באותיות קטנות בלבד, ללא סימני פיסוק, ללא רווחים מובילים או נגררים, ומגובב באמצעות SHA-256.
|
regionCode |
string
חובה. קוד האזור בן 2 האותיות בפורמט ISO-3166-1 alpha-2 של כתובת המשתמש.
|
postalCode |
string
חובה. המיקוד של כתובת המשתמש.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
