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