Bu kılavuzda, Google Meet REST API'yi kullanarak geçmiş bir konferansa katılan veya etkin bir konferansta bulunan katılımcılarla ilgili ayrıntıları ve oturum bilgilerini nasıl alacağınız açıklanmaktadır.
Katılımcı, bir aramaya katılan, Tamamlayıcı Mod'u kullanan, izleyici olarak izleyen veya bir aramaya bağlı olan bir oda cihazıdır. Her kişi için bir
participants
kaynak vardır.
Katılımcı oturumu, bir görüşmeye katılan her katılımcı-cihaz çifti için oluşturulan benzersiz bir oturum kimliğidir.
Her oturum için bir participantSessions
kaynağı bulunur. Katılımcı aynı görüşmeye aynı katılımcı-cihaz çiftiyle birden fazla kez katılırsa her katılıma benzersiz oturum kimlikleri atanır.
Toplantı alanı sahibi veya katılımcısıysanız katılımcı kayıtlarını almak için hem participants
hem de participantSessions
kaynaklarında get()
ve list()
yöntemlerini çağırabilirsiniz.
Kullanıcı kimlik bilgileriyle kimlik doğrulama ve yetkilendirme, Google Meet uygulamalarının kullanıcı verilerine erişmesine ve kimliği doğrulanmış kullanıcı adına işlemler gerçekleştirmesine olanak tanır. Alan genelinde yetki ile kimlik doğrulama, her kullanıcının tek tek izin vermesine gerek olmadan bir uygulamanın hizmet hesabını kullanıcılarınızın verilerine erişebilmesi için yetkilendirmenize olanak tanır.
Katılımcı sayısı
Aşağıdaki bölümlerde, konferans kaydındaki katılımcılar hakkında nasıl bilgi edinebileceğiniz ayrıntılı olarak açıklanmaktadır.
participants
kaynağı, user
alanı ile birleşir. user
yalnızca aşağıdaki nesnelerden biri olabilir:
signedinUser
şunlardan biri olabilir:Kişisel bilgisayardan, mobil cihazdan veya yardımcı modda katılan bir kişi
Konferans odası cihazları tarafından kullanılan bir robot hesabı.
anonymousUser
, Google Hesabı'nda oturum açmamış, tanımlanamayan bir kullanıcıdır.phoneUser
kullanıcının kimliği bilinmediği için telefondan arama yapan bir kullanıcıdır çünkü Google Hesabı ile oturum açmamıştır.
Üç nesnenin de displayName
döndürdüğünü ancak signedinUser
'nin, Yönetici SDK'sı API'si ve People API ile birlikte çalışabilen benzersiz bir user
kimliği de döndürdüğünü unutmayın. Biçim: users/{user}
. People API ile user
kimliğini kullanma hakkında daha fazla bilgi için People API ile katılımcı ayrıntılarını alma başlıklı makaleyi inceleyin.
Bir katılımcı hakkında ayrıntılı bilgi edinme
Belirli bir katılımcıyla ilgili ayrıntıları almak için name
yol parametresiyle birlikte participants
kaynağında get()
yöntemini kullanın. Katılımcı adını bilmiyorsanız list()
yöntemini kullanarak tüm katılımcı adlarını listeleyebilirsiniz.
Yöntem, katılımcı verilerini participants
kaynağının bir örneği olarak döndürür.
Aşağıdaki kod örneğinde, belirli bir katılımcının nasıl alınacağı gösterilmektedir:
Java
Node.js
Python
Katılımcı adını, konferans kaydındaki belirli katılımcı kimliğinin adıyla değiştirin.
Tüm katılımcıları listeleme
Bir konferans kaydındaki tüm katılımcılarla ilgili ayrıntıları listelemek için parent
yol parametresiyle birlikte participants
kaynağında list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}
.
Bu yöntem, konferans katılımcılarının listesini earliestStartTime
değerine göre azalan sırada participants
kaynağının bir örneği olarak döndürür. Sayfa boyutunu ayarlamak ve sorgu sonuçlarını filtrelemek için Sayfalandırmayı özelleştirme veya katılımcı listesini filtreleme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, bir konferans kaydındaki tüm katılımcıların nasıl listeleneceği gösterilmektedir:
Java
Node.js
Python
Üst değeri, konferans kaydının adıyla değiştirin.
Sayfalandırmayı özelleştirme veya katılımcı listesini filtreleme
Katılımcıların sayfalandırmasını özelleştirmek veya katılımcıları filtrelemek için aşağıdaki sorgu parametrelerini iletin:
pageSize
: Döndürülecek maksimum katılımcı sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemesi durumunda en fazla 100 katılımcı döndürülür. Maksimum değer 250'dir. 250'den büyük değerler otomatik olarak 250 olarak değiştirilir.pageToken
: Önceki bir liste çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu jetonu sağlayın.filter
: İsteğe bağlıdır.participants
kaynak sonuçlarındaki belirli öğeleri almak için kullanılan bir sorgu filtresi.Belirli bir zamandan önce katılan veya sonra ayrılan kullanıcıları filtrelemek için
earliestStartTime
veyalatestEndTime
alanlarını kullanabilirsiniz. Her iki alan da nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip RFC 3339 UTC "Zulu" biçiminde Timestamp biçimini kullanır:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Örneğin:earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
Mevcut bir konferanstaki tüm etkin katılımcıları listelemek için
latestEndTime IS NULL
komutunu kullanın.
People API ile katılımcı ayrıntılarını alma
Bir katılımcıyla ilgili ayrıntıları almak için People API'deki people
kaynağında get()
yöntemini kullanın.
Yolun sondaki bileşenini kullanarak
participant
kaynağındaki kişinin kimliğini ayıklayın. Örneğin,participant
kaynağının değericonferenceRecords/abc-123/participants/12345
ise People API'nin kimliği12345
olur.READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
veREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
değerlerini ekleyin. Bu sayede hem Google Workspace kuruluşundaki dahili kullanıcılar hem de harici kişiler yanıta dahil edilir.
Aşağıdaki kod örneğinde, hem kuruluş profillerinde hem de kişilerde bir kişinin nasıl aranacağı gösterilmektedir:
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
Aşağıdakini değiştirin:
- PERSON_ID: Bulunacak kişinin kimliği.
- ACCESS_TOKEN: Birden fazla API'ye erişim izni veren erişim jetonu.
Katılımcı oturumları
Aşağıdaki bölümlerde, konferans kaydındaki bir katılımcının oturumları hakkında nasıl bilgi edineceğiniz ayrıntılı olarak açıklanmaktadır.
Katılımcı oturumu hakkında ayrıntılı bilgi edinme
Belirli bir katılımcı oturumuyla ilgili ayrıntıları almak için name
yol parametresiyle birlikte participantSessions
kaynağında get()
yöntemini kullanın. Katılımcı oturum adını bilmiyorsanız list()
yöntemini kullanarak bir katılımcının tüm katılımcı oturumlarını listeleyebilirsiniz.
Yöntem, katılımcı adını participantSessions
kaynağı örneği olarak döndürür.
Aşağıdaki kod örneğinde, belirli bir katılımcı oturumunun nasıl alınacağı gösterilmektedir:
Java
Node.js
Python
Katılımcı adını, katılımcı oturumundaki belirli katılımcı oturumu kimliğiyle değiştirin.
Tüm katılımcı oturumlarını listeleme
Bir konferans kaydındaki katılımcının tüm katılımcı oturumlarıyla ilgili ayrıntıları listelemek için parent
yol parametresiyle birlikte participantSessions
kaynağında list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
Yöntem, startTime
kaynağının bir örneği olarak, startTime
ile azalan sırada sıralanmış katılımcı oturumlarının listesini döndürür.participantSession
Sayfa boyutunu ayarlamak ve sorgu sonuçlarını filtrelemek için Sayfalandırmayı özelleştirme veya katılımcı oturumları listesini filtreleme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, bir konferans kaydındaki tüm katılımcı oturumlarının nasıl listeleneceği gösterilmektedir:
Java
Node.js
Python
Üst değeri, konferans kaydındaki bir katılımcının oturumlarının adıyla değiştirin.
Sayfalandırmayı özelleştirme veya katılımcı oturumları listesini filtreleme
Katılımcı oturumlarının sayfalara ayrılmasını özelleştirmek veya oturumları filtrelemek için aşağıdaki isteğe bağlı sorgu parametrelerini iletin:
pageSize
: Döndürülecek maksimum katılımcı oturumu sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 100 katılımcı oturumu döndürülür. Maksimum değer 250'dir. 250'den büyük değerler otomatik olarak 250'ye değiştirilir.pageToken
: Önceki bir liste çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu jetonu sağlayın.filter
: İsteğe bağlıdır.participants
kaynak sonuçlarındaki belirli öğeleri almak için kullanılan bir sorgu filtresi.Belirli bir zamandan önce katılan veya sonra ayrılan kullanıcıları filtrelemek için
startTime
veyaendTime
alanlarını kullanabilirsiniz. Her iki alan da nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip RFC 3339 UTC "Zulu" biçiminde Timestamp biçimini kullanır:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
. Örneğin:startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
Konferans kaydındaki tüm etkin katılımcı oturumlarını listelemek için
endTime IS NULL
kullanın.