این راهنما نحوه دریافت جزئیات درباره شرکتکنندگانی که در کنفرانس گذشته شرکت کردهاند یا در یک کنفرانس فعال هستند، همراه با اطلاعات جلسه آنها با استفاده از Google Meet REST API توضیح میدهد.
شرکتکننده فردی است که به یک تماس ملحق شده است یا از حالت همراه استفاده میکند، بهعنوان بیننده تماشا میکند، یا یک دستگاه اتاق متصل به تماس. برای هر فرد یک منبع participants
وجود دارد.
جلسه شرکتکننده، شناسه جلسه منحصربهفردی است که برای هر جفت شرکتکننده-دستگاهی که به یک تماس میپیوندد ایجاد میشود. برای هر جلسه یک منبع participantSessions
وجود دارد. اگر شرکتکننده چندین بار از یک جفت شرکتکننده-دستگاه به یک تماس بپیوندد، به هر یک از آنها شناسههای جلسه منحصربهفرد اختصاص داده میشود.
اگر مالک یا شرکتکننده فضای جلسه هستید، میتوانید برای بازیابی سوابق شرکتکننده، متدهای get()
و list()
را هم در participants
و هم در منابع participantSessions
فراخوانی کنید.
احراز هویت و تأیید اعتبار با استفاده از اطلاعات کاربری به برنامههای Google Meet اجازه میدهد به دادههای کاربر دسترسی داشته باشند و عملیاتهایی را از طرف کاربر تأیید شده انجام دهند. احراز هویت با تفویض اختیار در سطح دامنه به شما امکان میدهد به حساب سرویس یک برنامه اجازه دهید بدون نیاز به رضایت هر کاربر به دادههای کاربرانتان دسترسی داشته باشد.
شرکت کنندگان
بخشهای زیر نحوه دریافت اطلاعات درباره شرکتکنندگان در یک رکورد کنفرانس را شرح میدهد.
participants
اتحادیههای منابع را با فیلد user
تامین میکنند. یک user
می تواند تنها یکی از اشیاء زیر باشد:
یک
signedinUser
یکی است:فردی که از رایانه شخصی، دستگاه تلفن همراه یا از طریق حالت Companion ملحق می شود.
یک حساب رباتی که توسط دستگاه های اتاق کنفرانس استفاده می شود.
یک
anonymousUser
یک کاربر ناشناس است که به یک حساب Google وارد نشده است.phoneUser
کاربری است که از تلفنی تماس می گیرد که هویت کاربر ناشناخته است زیرا با یک حساب Google وارد نشده است.
توجه داشته باشید که در حالی که هر سه شیء یک displayName
برمیگردانند، signedinUser
یک شناسه user
منحصر به فرد را نیز برمیگرداند که با Admin SDK API و People API قابل همکاری است. قالب: users/{user}
. برای اطلاعات بیشتر در مورد استفاده از شناسه user
با People API، به بازیابی جزئیات شرکتکننده با People API مراجعه کنید.
جزئیات یک شرکت کننده را دریافت کنید
برای دریافت جزئیات در مورد یک شرکتکننده خاص، از متد get()
در منبع participants
با پارامتر مسیر name
استفاده کنید. اگر نام شرکتکننده را نمیدانید، میتوانید همه نامهای شرکتکننده را با استفاده از متد list()
فهرست کنید.
این روش دادههای شرکتکننده را به عنوان نمونهای از منبع participants
برمیگرداند.
نمونه کد زیر نحوه بازیابی یک شرکتکننده خاص را نشان میدهد:
نام شرکت کننده را با نام شناسه شرکت کننده خاص در رکورد کنفرانس جایگزین کنید.
لیست همه شرکت کنندگان
برای فهرست کردن جزئیات مربوط به همه شرکت کنندگان در یک رکورد کنفرانس، از متد list()
در منبع participants
با پارامتر مسیر parent
استفاده کنید. فرمت: conferenceRecords/{conferenceRecord}
.
این روش فهرستی از شرکت کنندگان در کنفرانس را که توسط earliestStartTime
به ترتیب نزولی مرتب شده اند، به عنوان نمونه ای از منابع participants
برمی گرداند. برای تنظیم اندازه صفحه و فیلتر کردن نتایج پرس و جو، به سفارشی کردن صفحه بندی یا فیلتر کردن لیست شرکت کنندگان مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن همه شرکت کنندگان در یک رکورد کنفرانس را نشان می دهد:
مقدار والد را با نام رکورد کنفرانس جایگزین کنید.
صفحه بندی را سفارشی کنید یا لیست شرکت کنندگان را فیلتر کنید
برای سفارشی کردن صفحه بندی یا فیلتر کردن شرکت کنندگان، پارامترهای پرس و جو زیر را ارسال کنید:
pageSize
: حداکثر تعداد شرکت کنندگانی که باید برگردند. ممکن است این سرویس کمتر از این مقدار را برگرداند. اگر نامشخص باشد، حداکثر 100 شرکت کننده برگردانده می شوند. حداکثر مقدار 250 است. مقادیر بیش از 250 به طور خودکار به 250 تغییر می کند.pageToken
: یک نشانه صفحه، دریافت شده از یک تماس فهرست قبلی. این نشانه را برای بازیابی صفحه بعدی ارائه دهید.filter
: اختیاری یک فیلتر پرس و جو برای بازیابی موارد خاص در نتایج منابعparticipants
.میتوانید از فیلدهای
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
استفاده کنید.-
جزئیات شرکتکننده را با People API بازیابی کنید
برای بازیابی جزئیات در مورد یک شرکت کننده، از متد get()
در منبع people
در People API استفاده کنید.
شناسه شخص را از منبع
participant
با استفاده از جزء دنباله دار مسیر استخراج کنید. برای مثال، اگر مقدار منبعparticipant
conferenceRecords/abc-123/participants/12345
باشد، شناسه برای People API12345
است.شامل
READ_SOURCE_TYPE_PROFILE
،READ_SOURCE_TYPE_CONTACT
، وREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
. این اطمینان حاصل می کند که هم کاربران داخلی یک سازمان Google Workspace و هم مخاطبین خارجی در پاسخ گنجانده شده اند.
نمونه کد زیر نحوه جستجوی نمایههای سازمان و مخاطبین یک شخص را نشان میدهد:
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
موارد زیر را جایگزین کنید:
- PERSON_ID : شناسه شخصی که باید پیدا شود.
- ACCESS_TOKEN : نشانه دسترسی که به چندین API دسترسی می دهد.
جلسات شرکت کننده
بخشهای زیر نحوه دریافت اطلاعات درباره جلسات شرکتکننده یک شرکتکننده در رکورد کنفرانس را شرح میدهد.
جزئیات جلسه شرکت کننده را دریافت کنید
برای دریافت جزئیات در مورد یک جلسه شرکت کننده خاص، از متد get()
در منبع participantSessions
با پارامتر مسیر name
استفاده کنید. اگر نام جلسه شرکتکننده را نمیدانید، میتوانید تمام جلسات شرکتکننده یک شرکتکننده را با استفاده از متد list()
فهرست کنید.
این روش نام شرکت کننده را به عنوان نمونه ای از منبع participantSessions
برمی گرداند.
نمونه کد زیر نحوه بازیابی یک جلسه شرکت کننده خاص را نشان می دهد:
نام شرکت کننده را با نام شناسه جلسه شرکت کننده خاص در جلسه شرکت کننده جایگزین کنید.
لیست تمام جلسات شرکت کننده
برای فهرست کردن جزئیات مربوط به تمام جلسات شرکت کننده یک شرکت کننده در یک رکورد کنفرانس، از متد list()
در منبع participantSessions
با پارامتر مسیر parent
استفاده کنید. قالب: conferenceRecords/{conferenceRecord}/participants/{participant}
.
این روش فهرستی از جلسات شرکتکننده را که توسط startTime
به ترتیب نزولی مرتب شدهاند، به عنوان نمونهای از یک منبع participantSession
برمیگرداند. برای تنظیم اندازه صفحه و فیلتر کردن نتایج پرس و جو، به سفارشی کردن صفحه بندی مراجعه کنید یا لیست جلسات شرکت کننده را فیلتر کنید .
نمونه کد زیر نحوه فهرست کردن تمام جلسات شرکتکننده را در یک رکورد کنفرانس نشان میدهد:
مقدار والد را با نام جلسات شرکت کننده یک شرکت کننده در رکورد کنفرانس جایگزین کنید.
صفحه بندی را سفارشی کنید یا لیست جلسات شرکت کننده را فیلتر کنید
برای سفارشی کردن صفحه بندی یا فیلتر کردن جلسات شرکت کننده، پارامترهای پرس و جو اختیاری زیر را ارسال کنید:
pageSize
: حداکثر تعداد جلسات شرکت کننده برای بازگشت. ممکن است این سرویس کمتر از این مقدار را برگرداند. اگر مشخص نشده باشد، حداکثر 100 جلسه شرکت کننده برگردانده می شوند. حداکثر مقدار 250 است. مقادیر بیش از 250 به طور خودکار به 250 تغییر می کند.pageToken
: یک نشانه صفحه، دریافت شده از یک تماس فهرست قبلی. این نشانه را برای بازیابی صفحه بعدی ارائه دهید.filter
: اختیاری یک فیلتر پرس و جو برای بازیابی موارد خاص در نتایج منابعparticipants
.میتوانید از فیلدهای
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
برای فهرست کردن تمام جلسات شرکتکننده فعال در رکورد کنفرانس،
endTime IS NULL
استفاده کنید.-
این راهنما نحوه دریافت جزئیات درباره شرکتکنندگانی که در کنفرانس گذشته شرکت کردهاند یا در یک کنفرانس فعال هستند، همراه با اطلاعات جلسه آنها با استفاده از Google Meet REST API توضیح میدهد.
شرکتکننده فردی است که به یک تماس ملحق شده است یا از حالت همراه استفاده میکند، بهعنوان بیننده تماشا میکند، یا یک دستگاه اتاق متصل به تماس. برای هر فرد یک منبع participants
وجود دارد.
جلسه شرکتکننده، شناسه جلسه منحصربهفردی است که برای هر جفت شرکتکننده-دستگاهی که به یک تماس میپیوندد ایجاد میشود. برای هر جلسه یک منبع participantSessions
وجود دارد. اگر شرکتکننده چندین بار از یک جفت شرکتکننده-دستگاه به یک تماس بپیوندد، به هر یک از آنها شناسههای جلسه منحصربهفرد اختصاص داده میشود.
اگر مالک یا شرکتکننده فضای جلسه هستید، میتوانید برای بازیابی سوابق شرکتکننده، متدهای get()
و list()
را هم در participants
و هم در منابع participantSessions
فراخوانی کنید.
احراز هویت و تأیید اعتبار با استفاده از اطلاعات کاربری به برنامههای Google Meet اجازه میدهد به دادههای کاربر دسترسی داشته باشند و عملیاتهایی را از طرف کاربر تأیید شده انجام دهند. احراز هویت با تفویض اختیار در سطح دامنه به شما امکان میدهد به حساب سرویس یک برنامه اجازه دهید بدون نیاز به رضایت هر کاربر به دادههای کاربرانتان دسترسی داشته باشد.
شرکت کنندگان
بخشهای زیر نحوه دریافت اطلاعات درباره شرکتکنندگان در یک رکورد کنفرانس را شرح میدهد.
participants
اتحادیههای منابع را با فیلد user
تامین میکنند. یک user
می تواند تنها یکی از اشیاء زیر باشد:
یک
signedinUser
یکی است:فردی که از رایانه شخصی، دستگاه تلفن همراه یا از طریق حالت Companion ملحق می شود.
یک حساب رباتی که توسط دستگاه های اتاق کنفرانس استفاده می شود.
یک
anonymousUser
یک کاربر ناشناس است که به یک حساب Google وارد نشده است.phoneUser
کاربری است که از تلفنی تماس می گیرد که هویت کاربر ناشناخته است زیرا با یک حساب Google وارد نشده است.
توجه داشته باشید که در حالی که هر سه شیء یک displayName
برمیگردانند، signedinUser
یک شناسه user
منحصر به فرد را نیز برمیگرداند که با Admin SDK API و People API قابل همکاری است. قالب: users/{user}
. برای اطلاعات بیشتر در مورد استفاده از شناسه user
با People API، به بازیابی جزئیات شرکتکننده با People API مراجعه کنید.
جزئیات یک شرکت کننده را دریافت کنید
برای دریافت جزئیات در مورد یک شرکتکننده خاص، از متد get()
در منبع participants
با پارامتر مسیر name
استفاده کنید. اگر نام شرکتکننده را نمیدانید، میتوانید همه نامهای شرکتکننده را با استفاده از متد list()
فهرست کنید.
این روش دادههای شرکتکننده را به عنوان نمونهای از منبع participants
برمیگرداند.
نمونه کد زیر نحوه بازیابی یک شرکتکننده خاص را نشان میدهد:
نام شرکت کننده را با نام شناسه شرکت کننده خاص در رکورد کنفرانس جایگزین کنید.
لیست همه شرکت کنندگان
برای فهرست کردن جزئیات مربوط به همه شرکت کنندگان در یک رکورد کنفرانس، از متد list()
در منبع participants
با پارامتر مسیر parent
استفاده کنید. فرمت: conferenceRecords/{conferenceRecord}
.
این روش فهرستی از شرکت کنندگان در کنفرانس را که توسط earliestStartTime
به ترتیب نزولی مرتب شده اند، به عنوان نمونه ای از منابع participants
برمی گرداند. برای تنظیم اندازه صفحه و فیلتر کردن نتایج پرس و جو، به سفارشی کردن صفحه بندی یا فیلتر کردن لیست شرکت کنندگان مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن همه شرکت کنندگان در یک رکورد کنفرانس را نشان می دهد:
مقدار والد را با نام رکورد کنفرانس جایگزین کنید.
صفحه بندی را سفارشی کنید یا لیست شرکت کنندگان را فیلتر کنید
برای سفارشی کردن صفحه بندی یا فیلتر کردن شرکت کنندگان، پارامترهای پرس و جو زیر را ارسال کنید:
pageSize
: حداکثر تعداد شرکت کنندگانی که باید برگردند. ممکن است این سرویس کمتر از این مقدار را برگرداند. اگر نامشخص باشد، حداکثر 100 شرکت کننده برگردانده می شوند. حداکثر مقدار 250 است. مقادیر بیش از 250 به طور خودکار به 250 تغییر می کند.pageToken
: یک نشانه صفحه، دریافت شده از یک تماس فهرست قبلی. این نشانه را برای بازیابی صفحه بعدی ارائه دهید.filter
: اختیاری یک فیلتر پرس و جو برای بازیابی موارد خاص در نتایج منابعparticipants
.میتوانید از فیلدهای
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
استفاده کنید.-
جزئیات شرکتکننده را با People API بازیابی کنید
برای بازیابی جزئیات در مورد یک شرکت کننده، از متد get()
در منبع people
در People API استفاده کنید.
شناسه شخص را از منبع
participant
با استفاده از جزء دنباله دار مسیر استخراج کنید. برای مثال، اگر مقدار منبعparticipant
conferenceRecords/abc-123/participants/12345
باشد، شناسه برای People API12345
است.شامل
READ_SOURCE_TYPE_PROFILE
،READ_SOURCE_TYPE_CONTACT
، وREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
. این اطمینان حاصل می کند که هم کاربران داخلی یک سازمان Google Workspace و هم مخاطبین خارجی در پاسخ گنجانده شده اند.
نمونه کد زیر نحوه جستجوی نمایههای سازمان و مخاطبین یک شخص را نشان میدهد:
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
موارد زیر را جایگزین کنید:
- PERSON_ID : شناسه شخصی که باید پیدا شود.
- ACCESS_TOKEN : نشانه دسترسی که به چندین API دسترسی می دهد.
جلسات شرکت کننده
بخشهای زیر نحوه دریافت اطلاعات درباره جلسات شرکتکننده یک شرکتکننده در رکورد کنفرانس را شرح میدهد.
جزئیات جلسه شرکت کننده را دریافت کنید
برای دریافت جزئیات در مورد یک جلسه شرکت کننده خاص، از متد get()
در منبع participantSessions
با پارامتر مسیر name
استفاده کنید. اگر نام جلسه شرکتکننده را نمیدانید، میتوانید تمام جلسات شرکتکننده یک شرکتکننده را با استفاده از متد list()
فهرست کنید.
این روش نام شرکت کننده را به عنوان نمونه ای از منبع participantSessions
برمی گرداند.
نمونه کد زیر نحوه بازیابی یک جلسه شرکت کننده خاص را نشان می دهد:
نام شرکت کننده را با نام شناسه جلسه شرکت کننده خاص در جلسه شرکت کننده جایگزین کنید.
لیست تمام جلسات شرکت کننده
برای فهرست کردن جزئیات مربوط به تمام جلسات شرکت کننده یک شرکت کننده در یک رکورد کنفرانس، از متد list()
در منبع participantSessions
با پارامتر مسیر parent
استفاده کنید. قالب: conferenceRecords/{conferenceRecord}/participants/{participant}
.
این روش فهرستی از جلسات شرکتکننده را که توسط startTime
به ترتیب نزولی مرتب شدهاند، به عنوان نمونهای از یک منبع participantSession
برمیگرداند. برای تنظیم اندازه صفحه و فیلتر کردن نتایج پرس و جو، به سفارشی کردن صفحه بندی مراجعه کنید یا لیست جلسات شرکت کننده را فیلتر کنید .
نمونه کد زیر نحوه فهرست کردن تمام جلسات شرکتکننده را در یک رکورد کنفرانس نشان میدهد:
مقدار والد را با نام جلسات شرکت کننده یک شرکت کننده در رکورد کنفرانس جایگزین کنید.
صفحه بندی را سفارشی کنید یا لیست جلسات شرکت کننده را فیلتر کنید
برای سفارشی کردن صفحه بندی یا فیلتر کردن جلسات شرکت کننده، پارامترهای پرس و جو اختیاری زیر را ارسال کنید:
pageSize
: حداکثر تعداد جلسات شرکت کننده برای بازگشت. ممکن است این سرویس کمتر از این مقدار را برگرداند. اگر مشخص نشده باشد، حداکثر 100 جلسه شرکت کننده برگردانده می شوند. حداکثر مقدار 250 است. مقادیر بیش از 250 به طور خودکار به 250 تغییر می کند.pageToken
: یک نشانه صفحه، دریافت شده از یک تماس فهرست قبلی. این نشانه را برای بازیابی صفحه بعدی ارائه دهید.filter
: اختیاری یک فیلتر پرس و جو برای بازیابی موارد خاص در نتایج منابعparticipants
.میتوانید از فیلدهای
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
برای فهرست کردن تمام جلسات شرکتکننده فعال در رکورد کنفرانس،
endTime IS NULL
استفاده کنید.-
این راهنما نحوه دریافت جزئیات درباره شرکتکنندگانی که در کنفرانس گذشته شرکت کردهاند یا در یک کنفرانس فعال هستند، همراه با اطلاعات جلسه آنها با استفاده از Google Meet REST API توضیح میدهد.
شرکتکننده فردی است که به یک تماس ملحق شده است یا از حالت همراه استفاده میکند، بهعنوان بیننده تماشا میکند، یا یک دستگاه اتاق متصل به تماس. برای هر فرد یک منبع participants
وجود دارد.
جلسه شرکتکننده، شناسه جلسه منحصربهفردی است که برای هر جفت شرکتکننده-دستگاهی که به یک تماس میپیوندد ایجاد میشود. برای هر جلسه یک منبع participantSessions
وجود دارد. اگر شرکتکننده چندین بار از یک جفت شرکتکننده-دستگاه به یک تماس بپیوندد، به هر یک از آنها شناسههای جلسه منحصربهفرد اختصاص داده میشود.
اگر مالک یا شرکتکننده فضای جلسه هستید، میتوانید برای بازیابی سوابق شرکتکننده، متدهای get()
و list()
را هم در participants
و هم در منابع participantSessions
فراخوانی کنید.
احراز هویت و تأیید اعتبار با استفاده از اطلاعات کاربری به برنامههای Google Meet اجازه میدهد به دادههای کاربر دسترسی داشته باشند و عملیاتهایی را از طرف کاربر تأیید شده انجام دهند. احراز هویت با تفویض اختیار در سطح دامنه به شما امکان میدهد به حساب سرویس یک برنامه اجازه دهید بدون نیاز به رضایت هر کاربر به دادههای کاربرانتان دسترسی داشته باشد.
شرکت کنندگان
بخشهای زیر نحوه دریافت اطلاعات درباره شرکتکنندگان در یک رکورد کنفرانس را شرح میدهد.
participants
اتحادیههای منابع را با فیلد user
تامین میکنند. یک user
می تواند تنها یکی از اشیاء زیر باشد:
یک
signedinUser
یکی است:فردی که از رایانه شخصی، دستگاه تلفن همراه یا از طریق حالت Companion ملحق می شود.
یک حساب رباتی که توسط دستگاه های اتاق کنفرانس استفاده می شود.
یک
anonymousUser
یک کاربر ناشناس است که به یک حساب Google وارد نشده است.phoneUser
کاربری است که از تلفنی تماس می گیرد که هویت کاربر ناشناخته است زیرا با یک حساب Google وارد نشده است.
توجه داشته باشید که در حالی که هر سه شیء یک displayName
برمیگردانند، signedinUser
یک شناسه user
منحصر به فرد را نیز برمیگرداند که با Admin SDK API و People API قابل همکاری است. قالب: users/{user}
. برای اطلاعات بیشتر در مورد استفاده از شناسه user
با People API، به بازیابی جزئیات شرکتکننده با People API مراجعه کنید.
جزئیات یک شرکت کننده را دریافت کنید
برای دریافت جزئیات در مورد یک شرکتکننده خاص، از متد get()
در منبع participants
با پارامتر مسیر name
استفاده کنید. اگر نام شرکتکننده را نمیدانید، میتوانید همه نامهای شرکتکننده را با استفاده از متد list()
فهرست کنید.
این روش دادههای شرکتکننده را به عنوان نمونهای از منبع participants
برمیگرداند.
نمونه کد زیر نحوه بازیابی یک شرکتکننده خاص را نشان میدهد:
نام شرکت کننده را با نام شناسه شرکت کننده خاص در رکورد کنفرانس جایگزین کنید.
لیست همه شرکت کنندگان
برای فهرست کردن جزئیات مربوط به همه شرکت کنندگان در یک رکورد کنفرانس، از متد list()
در منبع participants
با پارامتر مسیر parent
استفاده کنید. فرمت: conferenceRecords/{conferenceRecord}
.
این روش فهرستی از شرکت کنندگان در کنفرانس را که توسط earliestStartTime
به ترتیب نزولی مرتب شده اند، به عنوان نمونه ای از منابع participants
برمی گرداند. برای تنظیم اندازه صفحه و فیلتر کردن نتایج پرس و جو، به سفارشی کردن صفحه بندی یا فیلتر کردن لیست شرکت کنندگان مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن همه شرکت کنندگان در یک رکورد کنفرانس را نشان می دهد:
مقدار والد را با نام رکورد کنفرانس جایگزین کنید.
صفحه بندی را سفارشی کنید یا لیست شرکت کنندگان را فیلتر کنید
برای سفارشی کردن صفحه بندی یا فیلتر کردن شرکت کنندگان، پارامترهای پرس و جو زیر را ارسال کنید:
pageSize
: حداکثر تعداد شرکت کنندگانی که باید برگردند. ممکن است این سرویس کمتر از این مقدار را برگرداند. اگر نامشخص باشد، حداکثر 100 شرکت کننده برگردانده می شوند. حداکثر مقدار 250 است. مقادیر بیش از 250 به طور خودکار به 250 تغییر می کند.pageToken
: یک نشانه صفحه، دریافت شده از یک تماس فهرست قبلی. این نشانه را برای بازیابی صفحه بعدی ارائه دهید.filter
: اختیاری یک فیلتر پرس و جو برای بازیابی موارد خاص در نتایج منابعparticipants
.میتوانید از فیلدهای
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
استفاده کنید.-
جزئیات شرکتکننده را با People API بازیابی کنید
برای بازیابی جزئیات در مورد یک شرکت کننده، از متد get()
در منبع people
در People API استفاده کنید.
شناسه شخص را از منبع
participant
با استفاده از جزء دنباله دار مسیر استخراج کنید. برای مثال، اگر مقدار منبعparticipant
conferenceRecords/abc-123/participants/12345
باشد، شناسه برای People API12345
است.شامل
READ_SOURCE_TYPE_PROFILE
،READ_SOURCE_TYPE_CONTACT
، وREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
. این اطمینان حاصل می کند که هم کاربران داخلی یک سازمان Google Workspace و هم مخاطبین خارجی در پاسخ گنجانده شده اند.
نمونه کد زیر نحوه جستجوی نمایههای سازمان و مخاطبین یک شخص را نشان میدهد:
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
موارد زیر را جایگزین کنید:
- PERSON_ID : شناسه شخصی که باید پیدا شود.
- ACCESS_TOKEN : نشانه دسترسی که به چندین API دسترسی می دهد.
جلسات شرکت کننده
بخشهای زیر نحوه دریافت اطلاعات درباره جلسات شرکتکننده یک شرکتکننده در رکورد کنفرانس را شرح میدهد.
جزئیات جلسه شرکت کننده را دریافت کنید
برای دریافت جزئیات در مورد یک جلسه شرکت کننده خاص، از متد get()
در منبع participantSessions
با پارامتر مسیر name
استفاده کنید. اگر نام جلسه شرکتکننده را نمیدانید، میتوانید تمام جلسات شرکتکننده یک شرکتکننده را با استفاده از متد list()
فهرست کنید.
این روش نام شرکت کننده را به عنوان نمونه ای از منبع participantSessions
برمی گرداند.
نمونه کد زیر نحوه بازیابی یک جلسه شرکت کننده خاص را نشان می دهد:
نام شرکت کننده را با نام شناسه جلسه شرکت کننده خاص در جلسه شرکت کننده جایگزین کنید.
لیست تمام جلسات شرکت کننده
برای فهرست کردن جزئیات مربوط به تمام جلسات شرکت کننده یک شرکت کننده در یک رکورد کنفرانس، از متد list()
در منبع participantSessions
با پارامتر مسیر parent
استفاده کنید. قالب: conferenceRecords/{conferenceRecord}/participants/{participant}
.
این روش فهرستی از جلسات شرکتکننده را که توسط startTime
به ترتیب نزولی مرتب شدهاند، به عنوان نمونهای از یک منبع participantSession
برمیگرداند. برای تنظیم اندازه صفحه و فیلتر کردن نتایج پرس و جو، به سفارشی کردن صفحه بندی مراجعه کنید یا لیست جلسات شرکت کننده را فیلتر کنید .
نمونه کد زیر نحوه فهرست کردن تمام جلسات شرکتکننده را در یک رکورد کنفرانس نشان میدهد:
مقدار والد را با نام جلسات شرکت کننده یک شرکت کننده در رکورد کنفرانس جایگزین کنید.
صفحه بندی را سفارشی کنید یا لیست جلسات شرکت کننده را فیلتر کنید
برای سفارشی کردن صفحه بندی یا فیلتر کردن جلسات شرکت کننده، پارامترهای پرس و جو اختیاری زیر را ارسال کنید:
pageSize
: حداکثر تعداد جلسات شرکت کننده برای بازگشت. ممکن است این سرویس کمتر از این مقدار را برگرداند. اگر مشخص نشده باشد، حداکثر 100 جلسه شرکت کننده برگردانده می شوند. حداکثر مقدار 250 است. مقادیر بیش از 250 به طور خودکار به 250 تغییر می کند.pageToken
: یک نشانه صفحه، دریافت شده از یک تماس فهرست قبلی. این نشانه را برای بازیابی صفحه بعدی ارائه دهید.filter
: اختیاری یک فیلتر پرس و جو برای بازیابی موارد خاص در نتایج منابعparticipants
.میتوانید از فیلدهای
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
برای فهرست کردن تمام جلسات شرکتکننده فعال در رکورد کنفرانس،
endTime IS NULL
استفاده کنید.-