The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
تنسيق بيانات المستخدمين
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح واجهة برمجة التطبيقات Data Manager API تحميل أنواع متعدّدة من بيانات المستخدمين. اتّبِع متطلبات التنسيق والتجزئة والترميز لكل عنصر من عناصر البيانات لضمان تلقّي بياناتك ومعالجتها بنجاح.
كائن UserData هو مجموعة من كائنات UserIdentifier. تحتوي كل
UserIdentifier على سمة واحدة فقط من السمات الواردة في الجدول التالي.
| UserIdentifier |
email_address |
| التنسيق |
string
تحويل النص إلى أحرف لاتينية صغيرة
|
| مسافة بيضاء |
إزالة المسافات البيضاء البادئة واللاحقة والمتوسطة |
| التجزئة |
يجب التجزئة باستخدام خوارزمية SHA-256.
رمِّز وحدات البايت المجزّأة باستخدام ترميز hex أو Base64.
|
|
phone_number |
| التنسيق |
string
يجب تضمين علامة الجمع (+) ورمز البلد.
|
| مسافة بيضاء |
إزالة المسافات البيضاء البادئة واللاحقة |
| التجزئة |
يجب التجزئة باستخدام خوارزمية SHA-256.
رمِّز وحدات البايت المجزّأة باستخدام ترميز hex أو Base64.
|
|
address |
|
استخدِم إرشادات التنسيق التالية لإنشاء السمة address الخاصة بـ UserIdentifier.
| AddressInfo |
given_name |
| التنسيق |
string
تحويل النص إلى أحرف لاتينية صغيرة
لا تُدرِج بادئات مثل Mrs.
|
| مسافة بيضاء |
إزالة المسافات البيضاء البادئة واللاحقة |
| التجزئة |
يجب التجزئة باستخدام خوارزمية SHA-256.
رمِّز وحدات البايت المجزّأة باستخدام ترميز hex أو Base64.
|
|
family_name |
| التنسيق |
string
تحويل النص إلى أحرف لاتينية صغيرة
لا تُدرِج لاحقات مثل Jr.
|
| مسافة بيضاء |
إزالة المسافات البيضاء البادئة واللاحقة |
| التجزئة |
يجب التجزئة باستخدام خوارزمية SHA-256.
رمِّز وحدات البايت المجزّأة باستخدام ترميز hex أو Base64.
|
|
region_code |
| التنسيق |
string
|
| مسافة بيضاء |
إزالة المسافات البيضاء البادئة واللاحقة |
| التجزئة |
لا تجزّئ region_code. |
|
postal_code |
| التنسيق |
string
مسموح باستخدام الرموز البريدية الأمريكية والدولية.
بالنسبة إلى العناوين في الولايات المتحدة، استخدِم إما 5 أرقام أو 5 أرقام متبوعة برقم إضافي مكوّن من 4 أرقام. قد يؤدي استخدام إضافة مكوّنة من 4 أرقام إلى تحسين نسبة المطابقة.
بالنسبة إلى جميع البلدان الأخرى، لا تستخدِم إضافات الرموز البريدية.
|
| مسافة بيضاء |
إزالة المسافات البيضاء البادئة واللاحقة |
| التجزئة |
لا تجزّئ postal_code. |
|
املأ الحقل pair_ids الخاص بالكائن PairData بقائمة من أرقام التعريف.
نسِّق كل عنصر في القائمة باتّباع الخطوات التالية:
- جزِّئ بيانات معلومات تحديد الهوية الشخصية المقدَّمة من مساحة العرض المحمي باستخدام خوارزمية SHA-256.
- يتم تشفير وحدات البايت الخاصة بالتجزئة باستخدام رمز تشفير تبادلي لمنحنى قطع ناقص باستخدام مفتاح الناشر
لقائمة المستخدمين PAIR.
- رمِّز البيانات المشفّرة باستخدام ترميز hex أو Base64.
املأ الحقل mobile_ids الخاص بالكائن MobileData بقائمة معرّفات الأجهزة الجوّالة. عدم تجزئة معرّفات الأجهزة الجوّالة
في حال استخدام تنسيق JSON للحقول Timestamp، مثل timestamp وlast_updated_timestamp في Event، استخدِم التنسيق RFC
3339.
في حال استخدام تنسيق بروتوكول المخزن المؤقت، اضبط seconds وnanos اختياريًا عند إنشاء Timestamp.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-09 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-09 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]
