Method: users.ingest

تحميل قائمة بالمستخدمين إلى الوجهات المقدَّمة على عكس audienceMembers.ingest (التي تضيف المستخدمين إلى قوائم جمهور المعلِنين المحدّدة للاستهداف)، تستوعب users.ingest بيانات ربط الهوية على مستوى الحساب (مثل معرّفات المستخدمين المرتبطة بمعرّفات الأجهزة الجوّالة) بغض النظر عن شرائح الجمهور المحدّدة.

هذه الميزة متاحة فقط للحسابات المُدرَجة في القائمة المسموح بها.

طلب HTTP

POST https://datamanager.googleapis.com/v1/users:ingest

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
الحقول
destinations[]

object (Destination)

الحقل مطلوب. قائمة بوجهات النقل المحتملة
users[]

object (User)

الحقل مطلوب. قائمة المستخدمين المطلوب استيعابهم
encryptionInfo

object (EncryptionInfo)

اختيارية: معلومات التشفير حول مفاتيح التشفير المستخدَمة لتشفير البيانات
validateOnly

boolean

اختيارية: إذا كانت القيمة true، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه.
encoding

enum (Encoding)

الحقل مطلوب. نوع الترميز لمعرّفات المستخدمين بالنسبة إلى معرّفات المستخدمين المشفّرة، ينطبق ذلك فقط على الترميز الخارجي.

نص الاستجابة

الردّ من IngestUsersRequest

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "requestId": string
}
الحقول
requestId

string

معرّف الطلب الذي تم إنشاؤه لطلب الاستيعاب

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/datamanager

المستخدم

يمثّل مستخدمًا واحدًا، ويحتوي على معرّفات مثل معلومات تكشف الهوية الشخصية وأرقام تعريف الأجهزة الجوّالة التي تشير جميعها إلى المستخدم نفسه.

تمثيل JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
الحقول
userData

object (UserData)

الحقل مطلوب. أجزاء متعدّدة من البيانات المقدَّمة من المستخدِم، وتُستخدَم كوسيلة لتحديد هوية المستخدِم
mobileData

object (MobileData)

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