REST Resource: properties.audienceLists

{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number,
  "recurringAudienceList": string,
  "webhookNotification": {
    object (WebhookNotification)
  }
}

string

النتائج فقط. المُعرّف. اسم مورد قائمة المستخدمين الذي تم تعيينه أثناء الإنشاء. يحدد اسم المورد هذا AudienceList.

تنسيق الملف: properties/{property}/audienceLists/{audienceList}

string

مطلوبة. اسم مورد الجمهور. يحدِّد اسم المورد هذا الجمهور الذي يتم إدراجه وتتم مشاركته بين "إحصاءات Google" Data وAdmin API.

تنسيق الملف: properties/{property}/audiences/{audience}

string

النتائج فقط. الاسم المعروض الوصفي لهذا الجمهور. على سبيل المثال، "المشترون".

object (AudienceDimension)

مطلوبة. السمات التي تم طلبها وعرضها في ردّ طلب البحث.

integer

النتائج فقط. الرموز المميّزة لإجمالي الحصة التي تم تحصيلها أثناء إنشاء AudienceList بما أنّ عدد الرموز المميّزة هذا يعتمد على النشاط في حالة CREATING، سيتم تثبيت هذه الرموز المميّزة التي يتم تحصيل رسومها بعد إدخال قائمة AudienceList حالتي ACTIVE أو FAILED.

enum (State)

النتائج فقط. الحالة الحالية لقائمة AudienceList هذه.

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه استدعاء userLists.create وبدأت AudienceList حالة CREATING.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

integer

النتائج فقط. إجمالي عدد الصفوف في نتيجة AudienceList.

string

النتائج فقط. تتم تعبئة رسالة الخطأ عند تعذُّر إنشاء قائمة مستخدمين أثناء إنشائها. والسبب الشائع لمثل هذا الإخفاق هو استنفاد الحصص.

number

النتائج فقط. النسبة المئوية المكتملة لتصدير شريحة الجمهور هذه تتراوح بين 0 و100.

string

النتائج فقط. قائمة المستخدمين المتكرّرة التي أنشأت قائمة المستخدمين هذه. تُنشئ قوائم المستخدِمين المتكرّرة قوائم مستخدِمين يوميًا.

إذا تم إنشاء قوائم المستخدمين مباشرةً، لن يتم ربطها بأي قائمة مستخدمين متكرّرة، وسيكون هذا الحقل فارغًا.

object (WebhookNotification)

اختياريّ. تعمل هذه السياسة على ضبط إشعارات الردّ التلقائي على الويب التي سيتم إرسالها من Google Analytics Data API إلى خادم الردّ التلقائي على الويب. إنّ استخدام الردود التلقائية على الويب أمر اختياري. وفي حال عدم استخدامها، ستحتاج إلى إجراء استطلاع رأي لواجهة برمجة التطبيقات هذه لتحديد الوقت الذي تصبح فيه قائمة المستخدمين جاهزة للاستخدام. تسمح الردود التلقائية على الويب بإرسال إشعار إلى خوادمك وتجنُّب الحاجة إلى الاستطلاع.

سيتم إرسال طلب واحد أو طلبَين من طلبات POST إلى الرد التلقائي على الويب. سيتم إرسال طلب POST الأول على الفور مع عرض قائمة المستخدمين التي تم إنشاؤها حديثًا في حالة الإنشاء. سيتم إرسال طلب POST الثاني بعد اكتمال عملية إنشاء قائمة المستخدمين (إما الحالة "نشط" أو الحالة "تعذّر").

إذا تم طلب قوائم مستخدمين متطابقة في تتابع سريع، يمكن عرض قوائم المستخدمين الثانية واللاحقة من ذاكرة التخزين المؤقت. في هذه الحالة، يمكن أن تؤدي طريقة إنشاء قائمة المستخدمين إلى أن تكون قائمة المستخدمين "نشطة". في هذا السيناريو، سيتم إرسال طلب POST واحد فقط إلى الرد التلقائي على الويب.