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

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

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

string

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

object (AudienceDimension)

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

integer

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

enum (State)

النتائج فقط. الحالة الحالية لعملية تصدير شرائح الجمهور هذه.
beginCreatingTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "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

 يسترجع عملية تصدير جمهور من المستخدِمين.