UserData

البيانات التي تحدّد هوية المستخدم يجب توفير معرّف واحد على الأقل.

تمثيل JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ]
}
الحقول
userIdentifiers[]

object (UserIdentifier)

الحقل مطلوب. معرّفات المستخدم يمكن تقديم عدة أمثلة من نوع البيانات نفسه (مثل عناوين بريد إلكتروني متعددة). لزيادة احتمال حدوث مطابقة، قدِّم أكبر عدد ممكن من المعرّفات. يمكن تقديم 10 userIdentifiers كحد أقصى في AudienceMember أو Event واحد.

UserIdentifier

معرّف واحد للمستخدم

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "phoneNumber": string,
  "address": {
    object (AddressInfo)
  }
  // End of mutually exclusive fields.
}
الحقول
يجب تحديد قيمة واحدة بالضبط. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
emailAddress

string

عنوان بريد إلكتروني مجزّأ باستخدام دالة التجزئة SHA-256 بعد التسوية
phoneNumber

string

رقم الهاتف المجزّأ باستخدام دالة التجزئة SHA-256 بعد التسوية (معيار E164)
address

object (AddressInfo)

العناصر المعروفة لعنوان المستخدم تحتوي على مجموعة من المعرّفات التي تتم مطابقتها كلها في آنٍ واحد.
نهاية الحقول التي يستبعد كلّ منها الآخر

AddressInfo

معلومات العنوان الخاصة بالمستخدم

تمثيل JSON 
{
  "givenName": string,
  "familyName": string,
  "regionCode": string,
  "postalCode": string,
  "addressLine": string,
  "city": string,
  "administrativeArea": string
}
الحقول
givenName

string

الحقل مطلوب. الاسم (الأول) للمستخدم، بأحرف صغيرة فقط، بدون علامات ترقيم، وبدون مسافات بيضاء في البداية أو النهاية، ومجزّأ باستخدام SHA-256
familyName

string

الحقل مطلوب. اسم العائلة (الأخير) للمستخدم، بأحرف صغيرة فقط، وبدون علامات ترقيم أو مسافات بيضاء في البداية أو النهاية، ومجزّأ باستخدام خوارزمية SHA-256
regionCode

string

الحقل مطلوب. يشير ذلك إلى رمز المنطقة المكوّن من حرفَين حسب المعيار ISO-3166-1 alpha-2 الخاص بعنوان المستخدِم.
postalCode

string

الحقل مطلوب. الرمز البريدي لعنوان المستخدم
addressLine

string

اختياريّ. يشير ذلك إلى الشارع ورقم عنوان المستخدِم. تُستخدَم فقط لخدمة "إحصاءات Google". يتم تشفير هذا الحقل وربما يتم ترميزه.

تسوية القيمة قبل التجزئة:

  • إزالة رموز الأحرف
  • تحويل النص إلى أحرف لاتينية صغيرة
  • إزالة المسافات البيضاء البادئة واللاحقة
city

string

اختياريّ. المدينة التي يقع فيها عنوان المستخدم تُستخدَم فقط لخدمة "إحصاءات Google".

يجب تنظيم القيمة على النحو التالي:

  • إزالة رموز الأحرف
  • تحويل النص إلى أحرف لاتينية صغيرة
  • إزالة المسافات البيضاء البادئة واللاحقة
administrativeArea

string

اختياريّ. المنطقة الإدارية (الولاية أو المقاطعة) لعنوان المستخدم تُستخدَم فقط لخدمة "إحصاءات Google".

يجب تنظيم القيمة على النحو التالي:

  • إزالة رموز الأحرف
  • تحويل النص إلى أحرف لاتينية صغيرة
  • إزالة المسافات البيضاء البادئة واللاحقة