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
}
الحقول
requestId

string

المعرّف الذي يتم إنشاؤه تلقائيًا للطلب.

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

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

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

TermsOfService

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

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

enum (TermsOfServiceStatus)

اختيارية: بنود خدمة "مطابقة العملاء": https://support.google.com/adspolicy/answer/6299717 يجب قبول ذلك لجميع عمليات التحميل إلى قوائم مستخدمي "مطابقة العملاء".

TermsOfServiceStatus

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

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