Method: users.ingest

فهرستی از کاربران را در مقصدهای ارائه شده بارگذاری می‌کند. برخلاف audienceMembers.ingest (که کاربران را برای هدف‌گیری به فهرست‌های خاص مخاطبان تبلیغ‌کننده اضافه می‌کند)، users.ingest داده‌های پیوند هویت سطح حساب (به عنوان مثال، شناسه‌های کاربر مرتبط با شناسه‌های تلفن همراه) را مستقل از بخش‌های خاص مخاطبان دریافت می‌کند.

این ویژگی فقط برای حساب‌های کاربری موجود در یک لیست مجاز در دسترس است.

درخواست HTTP

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

این URL از سینتکس Transcoding در 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

کاربر

یک کاربر واحد را نشان می‌دهد که شامل شناسه‌هایی مانند PII و شناسه‌های دستگاه تلفن همراه است که همگی به یک کاربر اشاره دارند.

نمایش JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
فیلدها
userData

object ( UserData )

الزامی. چندین قطعه داده ارائه شده توسط کاربر، که به عنوان وسیله‌ای برای شناسایی کاربر استفاده می‌شود.

mobileData

object ( MobileData )

الزامی. چندین رشته شناسه دستگاه تلفن همراه برای نمایش یک کاربر واحد.