Method: audienceMembers.ingest

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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 )

مورد نیاز. لیست کاربران برای ارسال به مقاصد مشخص شده. حداکثر 10000 منبع 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
}
فیلدها
requestId

string

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

محدوده مجوز

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

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

TermsOfService

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

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

enum ( TermsOfServiceStatus )

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

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

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

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