The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
UserData
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Dữ liệu nhận dạng người dùng. Bạn phải cung cấp ít nhất một giá trị nhận dạng.
Biểu diễn dưới dạng JSON |
{
"userIdentifiers": [
{
object (UserIdentifier )
}
]
} |
Trường |
userIdentifiers[] |
object (UserIdentifier )
Bắt buộc. Giá trị nhận dạng của người dùng. Bạn có thể cung cấp nhiều phiên bản của cùng một loại dữ liệu (ví dụ: nhiều địa chỉ email). Để tăng khả năng trùng khớp, hãy cung cấp càng nhiều giá trị nhận dạng càng tốt. Bạn có thể cung cấp tối đa 10 userIdentifiers trong một AudienceMember hoặc Event .
|
UserIdentifier
Giá trị nhận dạng duy nhất cho người dùng.
Biểu diễn dưới dạng 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 .
} |
Trường |
Trường nhóm identifier . Bạn phải chỉ định đúng một. identifier chỉ có thể là một trong những trạng thái sau: |
emailAddress |
string
Địa chỉ email đã băm bằng hàm băm SHA-256 sau khi chuẩn hoá.
|
phoneNumber |
string
Số điện thoại đã băm bằng hàm băm SHA-256 sau khi chuẩn hoá (tiêu chuẩn E164).
|
address |
object (AddressInfo )
Các thành phần đã biết trong địa chỉ của người dùng. Chứa một nhóm giá trị nhận dạng được so khớp cùng một lúc.
|
AddressInfo
Thông tin địa chỉ của người dùng.
Biểu diễn dưới dạng JSON |
{
"givenName": string,
"familyName": string,
"regionCode": string,
"postalCode": string
} |
Trường |
givenName |
string
Bắt buộc. Tên (tên) của người dùng, tất cả đều là chữ thường, không có dấu câu, không có khoảng trắng ở đầu hoặc cuối và được băm dưới dạng SHA-256.
|
familyName |
string
Bắt buộc. Họ của người dùng, tất cả đều là chữ thường, không có dấu câu, không có khoảng trắng ở đầu hoặc cuối và được băm dưới dạng SHA-256.
|
regionCode |
string
Bắt buộc. Mã vùng gồm 2 chữ cái theo chuẩn ISO-3166-1 alpha-2 của địa chỉ người dùng.
|
postalCode |
string
Bắt buộc. Mã bưu chính của địa chỉ người dùng.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]