Method: audienceMembers.ingest

تحميل قائمة بموارد AudienceMember إلى Destination المقدَّم

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل الترميز إلى 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)

الحقل مطلوب. قائمة المستخدمين الذين سيتم إرسالهم إلى الوجهات المحدّدة يمكن إرسال 10,000 مرجع 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

TermsOfService

بنود الخدمة التي قبلها المستخدم أو رفضها

تمثيل JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
الحقول
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

اختياريّ. بنود خدمة "مطابقة العملاء": https://support.google.com/adspolicy/answer/6299717 يجب قبول هذه الاتفاقية عند استيعاب UserData أو MobileData. هذا الحقل غير مطلوب لقائمة مستخدمي ميزة "مطابقة الشركاء".

TermsOfServiceStatus

تمثّل هذه السمة قرار المتصل بقبول بنود الخدمة أو رفضها.

عمليات التعداد
TERMS_OF_SERVICE_STATUS_UNSPECIFIED لم يتم تحديد أي قيمة.
ACCEPTED حالة تشير إلى أنّ المتصل اختار قبول بنود الخدمة.
REJECTED الحالة التي تشير إلى أنّ المتصل اختار رفض بنود الخدمة.