REST Resource: properties.audienceExports

المرجع: AudienceExport

تصدير شرائح الجمهور هو قائمة بالمستخدِمين في شريحة جمهور معيّنة وقت إنشاء القائمة. قد يكون لشريحة جمهور واحدة عمليات تصدير متعددة للجمهور تم إنشاؤها لأيام مختلفة.

تمثيل JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number
}
الحقول
name

string

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

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

string

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

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

string

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

object (AudienceDimension)

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

integer

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

enum (State)

النتائج فقط. الحالة الحالية لـ AudienceExport هذه.
beginCreatingTime

string (Timestamp format)

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

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

integer

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

string

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

number

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

AudienceDimension

سمة الجمهور هي سمة للمستخدِم. يتم طلب تحديد مصدر معيّن للمستخدمين، ثم عرضه لاحقًا في QueryAudienceExportResponse.

تمثيل JSON 
{
  "dimensionName": string
}
الحقول
dimensionName

string

اختياريّ. اسم واجهة برمجة التطبيقات للسمة. اطّلِع على أبعاد واجهة برمجة التطبيقات للاطّلاع على قائمة أسماء السمات.

الحالة

يتوفّر AudienceExport حاليًا في هذه الحالة.

عمليات التعداد
STATE_UNSPECIFIED ولن يتم مطلقًا استخدام الحالة غير المحدّدة.
CREATING جارٍ إنشاء AudienceExport حاليًا وستكون متاحة في المستقبل. يتم الإنشاء فورًا بعد استدعاء audienceExports.create.
ACTIVE تم إنشاء AudienceExport بالكامل، وهي جاهزة لطلب البحث. يتم تعديل AudienceExport إلى نشاط غير متزامن من الطلب. يستغرق ذلك بعض الوقت (مثلاً 15 دقيقة) بعد إنشاء طلب الإنشاء.
FAILED تعذّر إنشاء AudienceExport. من الممكن أن تنجح إعادة طلب تصدير الجمهور هذا.

الطُرق

create

 يتم إنشاء عملية تصدير بيانات شريحة الجمهور لاستردادها في وقت لاحق.

get

 الحصول على بيانات وصفية حول تصدير شريحة جمهور معيّنة

list

 يسرد جميع عمليات تصدير شرائح الجمهور لأحد المواقع.

query

 يسترد شرائح الجمهور التي تم تصديرها للمستخدمين.