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 ) اجزای شناخته شده آدرس کاربر. گروهی از شناسه‌ها را نگه می‌دارد که به یکباره مطابقت دارند. |
آدرس اطلاعات
| نمایندگی JSON |
|---|
{
"givenName": string,
"familyName": string,
"regionCode": string,
"postalCode": string
} |
| فیلدها |
|---|
givenName | string مورد نیاز. نام کاربر (اول) داده شده، تماماً با حروف کوچک، بدون علامت نقطه گذاری، بدون فضای خالی اصلی یا انتهایی، و به عنوان SHA-256 هش شده است. |
familyName | string مورد نیاز. نام خانوادگی (فامیل) کاربر، تماماً با حروف کوچک، بدون علامت نقطه گذاری، بدون فضای خالی اصلی یا انتهایی و هش شده به عنوان SHA-256. |
regionCode | string مورد نیاز. کد منطقه 2 حرفی در ISO-3166-1 آلفا-2 آدرس کاربر. |
postalCode | string مورد نیاز. کد پستی آدرس کاربر. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
