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
مطلوب. تمثّل هذه السمة رمز المنطقة المكوّن من حرفَين حسب المعيار ISO-3166-1 alpha-2 الخاص بعنوان المستخدم.
|
postalCode |
string
مطلوب. الرمز البريدي لعنوان المستخدم
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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. |"]]
