شرکتکننده فردی است که به یک تماس ملحق شده است یا از حالت همراه استفاده میکند، بهعنوان بیننده تماشا میکند، یا یک دستگاه اتاق متصل به تماس. برای هر فرد یک منبع conferenceRecords.participants
وجود دارد.
جلسه شرکتکننده، شناسه جلسه منحصربهفردی است که برای هر جفت شرکتکننده-دستگاهی که به یک تماس میپیوندد ایجاد میشود. برای هر جلسه یک منبع conferenceRecords.participants.participantSessions
وجود دارد. اگر شرکتکننده چندین بار از یک جفت شرکتکننده-دستگاه به یک تماس بپیوندد، به هر یک از آنها شناسههای جلسه منحصربهفرد اختصاص داده میشود.
این صفحه نحوه دریافت اطلاعات درباره همه شرکتکنندگانی که در یک کنفرانس شرکت کردهاند یا در آن حضور دارند، یا فقط درباره یک شرکتکننده، به همراه اطلاعات جلسه آنها توضیح میدهد.
شرکت کنندگان
بخشهای زیر نحوه دریافت اطلاعات درباره شرکتکنندگان را شرح میدهد.
منبع conferenceRecords.participants
شامل فیلد user
است. یک user
می تواند تنها یکی از اشیاء زیر باشد:
یک
signedinUser
یکی است:فردی که از رایانه شخصی، دستگاه تلفن همراه یا از طریق حالت Companion ملحق می شود.
یک حساب رباتی که توسط دستگاه های اتاق کنفرانس استفاده می شود.
یک
anonymousUser
یک کاربر ناشناس است که به یک حساب Google وارد نشده است.phoneUser
کاربری است که از تلفنی تماس می گیرد که هویت کاربر ناشناخته است زیرا با یک حساب Google وارد نشده است.
جستجو برای همه شرکت کنندگان
برای دریافت جزئیات درباره همه شرکت کنندگان در یک رکورد کنفرانس، از متد list()
در منبع conferenceRecords.participants
با پارامتر مسیر parent
استفاده کنید.
میتوانید از فیلدهای earliestStartTime
یا latestEndTime
برای فیلتر کردن کاربرانی که قبل یا بعد از زمان مشخصی عضو شدهاند استفاده کنید. هر دو فیلد از قالب مهر زمانی در قالب RFC 3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری استفاده میکنند: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. به عنوان مثال:
-
earliestStartTime < 2023-10-01T15:01:23Z
-
latestEndTime < 2023-10-01T15:01:23Z
برای دریافت شرکتکنندگان فعال در یک کنفرانس موجود، از latestEndTime IS NULL
استفاده کنید.
این روش فهرستی از شرکت کنندگان در کنفرانس را که بر اساس زمان پیوستن به ترتیب نزولی مرتب شده اند، به عنوان نمونه ای از منبع conferenceRecords.participants
برمی گرداند.
نمونه کد زیر نحوه فهرست کردن همه شرکت کنندگان در یک رکورد کنفرانس را نشان می دهد:
جاوا
Node.js
پایتون
مقدار والد را با نام رکورد کنفرانس جایگزین کنید.
یک شرکت کننده خاص را جستجو کنید
برای جستجوی یک شرکتکننده خاص، از متد get()
در منبع conferenceRecords.participants
با پارامتر مسیر name
استفاده کنید. برای بازیابی نام شرکت کننده، از روش conferenceRecords.participants.list
استفاده کنید.
این روش نام شرکت کننده را به عنوان نمونه ای از یک منبع conferenceRecords.participants
برمی گرداند.
نمونه کد زیر نحوه بازیابی یک شرکتکننده خاص را نشان میدهد:
جاوا
Node.js
پایتون
برای یافتن نام شرکت کننده را با نام شرکت کننده خاص جایگزین کنید.
جلسات شرکت کننده
بخشهای زیر نحوه دریافت اطلاعات درباره جلسات شرکتکننده را شرح میدهد.
جستجوی همه جلسات شرکت کننده
برای دریافت جزئیات در مورد تمام جلسات شرکت کننده یک شرکت کننده در یک رکورد کنفرانس، از روش list()
در منبع conferenceRecords.participants.participantSessions
با پارامتر مسیر parent
استفاده کنید.
میتوانید از فیلدهای startTime
یا endTime
برای فیلتر کردن کاربرانی استفاده کنید که قبل یا بعد از زمان مشخصی عضو شدهاند. هر دو فیلد از قالب مهر زمانی در قالب RFC 3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری استفاده میکنند: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. به عنوان مثال:
-
startTime < 2023-10-01T15:01:23Z
-
endTime < 2023-10-01T15:01:23Z
این روش فهرستی از جلسات شرکتکننده را که بر اساس زمان پیوستن به ترتیب نزولی مرتب شدهاند، به عنوان نمونهای از یک منبع conferenceRecords.participants.participantSession
برمیگرداند.
نمونه کد زیر نحوه فهرست کردن تمام جلسات شرکتکننده را در یک رکورد کنفرانس نشان میدهد:
جاوا
Node.js
پایتون
نام رکورد کنفرانس و نام شرکت کننده را جایگزین مقدار والد کنید.
برای یک جلسه شرکت کننده خاص جستجو کنید
برای جستجوی یک جلسه شرکت کننده خاص، از متد get()
در منبع conferenceRecords.participants.participantSessions
با پارامتر مسیر name
استفاده کنید. برای بازیابی نام شرکت کننده، از متد list()
استفاده کنید.
این روش نام شرکت کننده را به عنوان نمونه ای از یک منبع conferenceRecords.participants.participantSessions
برمی گرداند.
نمونه کد زیر نحوه بازیابی یک جلسه شرکت کننده خاص را نشان می دهد:
جاوا
Node.js
پایتون
برای یافتن نام شرکت کننده را با نام شرکت کننده خاص جایگزین کنید.
جزئیات شرکتکننده را با People API بازیابی کنید
برای بازیابی جزئیات یک شرکتکننده، از روش people.get
در People API استفاده کنید.
- شناسه شخص را از نام منبع شرکت کننده با استفاده از مؤلفه دنباله دار مسیر استخراج کنید. برای مثال، اگر نام منبع شرکتکننده
conferenceRecords/abc-123/participants/12345
باشد، شناسه People API12345
است. - شامل منابع
READ_SOURCE_TYPE_PROFILE
،READ_SOURCE_TYPE_CONTACT
، وREAD_SOURCE_TYPE_OTHER_CONTACT
. این تضمین می کند که هم کاربران داخلی یک سازمان Google Workspace و هم مخاطبین خارجی در پاسخ گنجانده شوند.
مثال زیر نمایههای سازمان و مخاطبین یک شخص را جستجو میکند:
CURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed