Method: audienceMembers.ingest

فهرستی از منابع AudienceMember را در Destination ارائه شده آپلود می‌کند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
فیلدها
destinations[]

object ( Destination )

الزامی. فهرست مقاصدی که مخاطبان باید به آنجا فرستاده شوند.

audienceMembers[]

object ( AudienceMember )

الزامی. فهرست کاربرانی که باید به مقصدهای مشخص‌شده ارسال شوند. حداکثر ۱۰۰۰۰ منبع AudienceMember را می‌توان در یک درخواست واحد ارسال کرد.

consent

object ( Consent )

اختیاری. رضایت در سطح درخواست برای همه کاربران در درخواست اعمال می‌شود. رضایت در سطح کاربر، رضایت در سطح درخواست را لغو می‌کند و می‌تواند در هر AudienceMember مشخص شود.

validateOnly

boolean

اختیاری. برای اهداف آزمایشی. اگر true ، درخواست اعتبارسنجی می‌شود اما اجرا نمی‌شود. فقط خطاها برگردانده می‌شوند، نه نتایج.

encoding

enum ( Encoding )

اختیاری. برای آپلودهای UserData الزامی است. نوع رمزگذاری شناسه‌های کاربر. برای شناسه‌های کاربر هش‌شده، این نوع رمزگذاری رشته هش‌شده است. برای شناسه‌های کاربر هش‌شده رمزگذاری‌شده، این نوع رمزگذاری رشته رمزگذاری‌شده بیرونی است، اما لزوماً رشته هش‌شده داخلی نیست، به این معنی که رشته هش‌شده داخلی می‌تواند به روشی متفاوت از رشته رمزگذاری‌شده بیرونی رمزگذاری شود. برای آپلودهای غیر UserData ، این فیلد نادیده گرفته می‌شود.

encryptionInfo

object ( EncryptionInfo )

اختیاری. اطلاعات رمزگذاری برای آپلودهای UserData . اگر تنظیم نشود، فرض بر این است که اطلاعات شناسایی آپلود شده هش شده اما رمزگذاری نشده‌اند. برای آپلودهای غیر UserData ، این فیلد نادیده گرفته می‌شود.

termsOfService

object ( TermsOfService )

اختیاری. شرایط خدماتی که کاربر پذیرفته/رد کرده است.

بدنه پاسخ

پاسخ از درخواست IngestAudienceMembersRequest .

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "requestId": string,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
فیلدها
requestId

string

شناسه‌ی خودکارِ ایجاد شده برای درخواست.

fieldWarnings[]

object ( FieldWarning )

هشدارهای دقیق در سطح ردیف با مسیرهای میدانی.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

شرایط خدمات

شرایط خدماتی که کاربر پذیرفته/رد کرده است.

نمایش JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
فیلدها
customerMatchTermsOfServiceStatus

enum ( TermsOfServiceStatus )

اختیاری. شرایط خدمات «مطابقت با مشتری»: https://support.google.com/adspolicy/answer/6299717 . این شرایط باید هنگام دریافت UserData یا MobileData پذیرفته شود. این فیلد برای فهرست کاربران «مطابقت با شریک» الزامی نیست.

وضعیت شرایط خدمات

نشان دهنده تصمیم تماس گیرنده برای پذیرش یا رد شرایط خدمات است.

انوم‌ها
TERMS_OF_SERVICE_STATUS_UNSPECIFIED مشخص نشده است.
ACCEPTED وضعیتی که نشان می‌دهد تماس‌گیرنده شرایط خدمات را پذیرفته است.
REJECTED وضعیتی که نشان می‌دهد تماس‌گیرنده تصمیم به رد شرایط خدمات گرفته است.