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" Data وAdmin API.

تنسيق الملف: 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 "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

 لاسترداد تصدير بيانات الجمهور من المستخدمين.