Method: conferenceRecords.participants.list

يسرد المشاركين في سجلّ مكالمة فيديو. يتم ترتيبها تلقائيًا حسب وقت الانضمام وبترتيب تنازلي. تتيح واجهة برمجة التطبيقات هذه استخدام fields كمعلَمات عادية مثل كل واجهات برمجة التطبيقات الأخرى. ومع ذلك، عند حذف معلَمة طلب fields، يتم ضبط الإعدادات التلقائية لواجهة برمجة التطبيقات هذه على 'participants/*, nextPageToken'.

طلب HTTP

GET https://meet.googleapis.com/v2/{parent=conferenceRecords/*}/participants

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

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

المعلمات
parent

string

مطلوب. تنسيق الملف: conferenceRecords/{conferenceRecord}

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

المعلمات
pageSize

integer

الحد الأقصى لعدد المشاركين للعودة. قد تعرض الخدمة أقل من هذه القيمة. وفي حال عدم تحديد ذلك، يتم إرجاع 100 مشارك كحدّ أقصى. الحد الأقصى للقيمة هو 250؛ يتم فرض القيم الأكبر من 250 على 250. وقد يتغيّر الحد الأقصى في المستقبل.

pageToken

string

تم عرض رمز الصفحة المميز من استدعاء القائمة السابق.

filter

string

اختياريّ. شرط الفلترة المحدد من قِبل المستخدم بتنسيق EBNF في ما يلي الحقول القابلة للفلترة:

  • earliest_start_time
  • latest_end_time

على سبيل المثال، تعرض الدالة latest_end_time IS NULL المشاركين النشطين في مكالمة الفيديو.

نص الطلب

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

نص الاستجابة

استجابة طريقة Shared.list.

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

تمثيل JSON
{
  "participants": [
    {
      object (Participant)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
الحقول
participants[]

object (Participant)

قائمة المشاركين في صفحة واحدة.

nextPageToken

string

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

totalSize

integer

الإجمالي، العدد الدقيق لـ participants. وبشكل تلقائي، لا يتم تضمين هذا الحقل في الرد. اضبط قناع الحقل في SystemParameterContext لتلقّي هذا الحقل في الاستجابة.

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

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

  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.