Method: properties.audienceExports.list

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

اطّلِع على إنشاء عملية تصدير للجمهور للاطّلاع على مقدمة عن عمليات تصدير شرائح الجمهور مع أمثلة.

تتضمّن واجهات برمجة التطبيقات Audience Export API بعض الطرق في الإصدار الأولي وغيرها من الطرق في الإصدار التجريبي. والهدف من ذلك هو تطوير الطرق لتحقيق استقرار الإصدار التجريبي بعد تلقّي بعض الملاحظات والآراء. لإرسال ملاحظاتك حول واجهة برمجة التطبيقات هذه، يُرجى ملء نموذج ملاحظات وآراء بشأن Audience Export API في "إحصاءات Google".

طلب HTTP

GET https://analyticsdata.googleapis.com/v1beta/{parent=properties/*}/audienceExports

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. سيتم إدراج جميع عمليات تصدير شرائح الجمهور لهذا الموقع في الردّ. تنسيق الملف: properties/{property}

معامِلات طلب البحث

المعلمات
pageSize

integer

اختياريّ. الحد الأقصى لعدد عمليات تصدير بيانات الجمهور المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. في حال عدم تحديد ذلك، سيتم عرض 200 عملية تصدير بيانات كحدّ أقصى. القيمة القصوى هي 1000 (سيتم فرض القيم الأعلى على الحد الأقصى).

pageToken

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "audienceExports.list". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى audienceExports.list مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

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

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "audienceExports": [
    {
      object (AudienceExport)
    }
  ],
  "nextPageToken": string
}
الحقول
audienceExports[]

object (AudienceExport)

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

nextPageToken

string

رمز مميز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

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

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics