Bu kılavuzda, Google Meet REST API'yi kullanarak geçmişte bir konferansa katılan veya etkin bir konferansta bulunan katılımcılarla ilgili ayrıntıların ve oturum bilgilerinin nasıl alınacağı açıklanmaktadır.
Katılımcı, görüşmeye katılan veya Tamamlayıcı Mod'u kullanarak izleyici olarak izleyen ya da görüşmeye bağlı bir oda cihazı kullanan kişidir. Her kişi için bir participants
kaynak vardır.
Katılımcı oturumu, 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ğı vardır. Katılımcı aynı görüşmeye aynı katılımcı-cihaz çiftinden birden çok kez katılırsa her katılımcıya 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 bilgileri ile 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, bir uygulamanın hizmet hesabını, kullanıcıların tek tek izin vermesine gerek olmadan kullanıcılarınızın verilerine erişmesi 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 edinileceği ayrıntılı olarak açıklanmıştır.
participants
kaynağı, user
alanıyla birleşir. user
yalnızca aşağıdaki nesnelerden biri olabilir:
signedinUser
şu iki seçenekten biridir:Kişisel bilgisayardan, mobil cihazdan veya Arkadaş modu üzerinden katılan bir kullanıcı.
Konferans odası cihazları tarafından kullanılan bir robot hesabı.
anonymousUser
, Google Hesabı'nda oturum açmamış, kimliği tanımlanmamış bir kullanıcıdır.phoneUser
, Google Hesabı ile oturum açmadığı için kimliği bilinmeyen bir telefondan katılan kullanıcıdır.
Üç nesnenin de bir displayName
döndürdüğünü ancak signedinUser
'un, 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}
. user
kimliğini People API ile kullanma hakkında daha fazla bilgi için People API ile katılımcı ayrıntılarını alma başlıklı makaleyi inceleyin.
Katılımcılarla ilgili ayrıntıları alma
Belirli bir katılımcı hakkında ayrıntılı bilgi edinmek için name
yol parametresini kullanarak participants
kaynağındaki 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ğı ö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 parametresini kullanarak participants
kaynağındaki list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}
.
Yöntem, participants
kaynağının bir örneği olarak earliestStartTime
değerine göre azalan düzende sıralanmış bir konferans katılımcıları listesi döndürür. Sayfa boyutunu ayarlamak ve sorgu sonuçlarını filtrelemek için Sayfalamayı ö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 öğe değerini konferans kaydının adıyla değiştirin.
Sayfalamayı özelleştirme veya katılımcı listesini filtreleme
Katılımcıların sayfalandırmasını özelleştirmek veya 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. Belirtilmemişse en fazla 100 katılımcı döndürülür. Maksimum değer 250'dir. 250'den fazla olan 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ı.participants
kaynak sonuçlarında belirli öğeleri almak için bir sorgu filtresi.Belirli bir zamandan önce katılan veya belirli bir zamandan sonra ayrılan kullanıcıları filtrelemek için
earliestStartTime
veyalatestEndTime
alanlarını kullanabilirsiniz. Her iki alan da RFC 3339 UTC "Zulu" biçiminde zaman damgası biçimini kullanır. Bu biçim nanosaniye çözünürlüktedir ve ondalık kısımda dokuz basamağa kadar yer vardı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
simgesini kullanın.
People API ile katılımcı ayrıntılarını alma
Bir katılımcı hakkında ayrıntıları almak için People API'deki people
kaynağında get()
yöntemini kullanın.
Yolun son bileşenini kullanarak kişinin kimliğini
participant
kaynağından çıkarı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
simgesini ekleyinReadSourceType
. Bu sayede hem Google Workspace kuruluşunun dahili kullanıcıları hem de kuruluş dışı kişiler yanıta dahil edilir.
Aşağıdaki kod örneğinde, bir kullanıcının hem kuruluş profillerinin hem de kişilerinin 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, bir konferans kaydındaki katılımcının katılımcı oturumları hakkında nasıl bilgi edinileceği ayrıntılı olarak açıklanmıştır.
Katılımcı oturumuyla ilgili ayrıntıları alma
Belirli bir katılımcı oturumuyla ilgili ayrıntıları almak için name
yol parametresini kullanarak participantSessions
kaynağındaki get()
yöntemini kullanın. Katılımcı oturumunun adını bilmiyorsanız list()
yöntemini kullanarak bir katılımcının tüm katılımcı oturumlarını listeleyebilirsiniz.
Yöntem, bir participantSessions
kaynağı örneği olarak katılımcı adı 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ı oturum kimliğinin adıyla 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 parametresini kullanarak participantSessions
kaynağındaki list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
Yöntem, participantSession
kaynağının bir örneği olarak startTime
'ye göre azalan düzende sıralanmış katılımcı oturumlarının listesini döndürür. Sayfa boyutunu ayarlamak ve sorgu sonuçlarını filtrelemek için Sayfalamayı ö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 öğe değerini, bir konferans kaydındaki katılımcının katılımcı oturumlarının adıyla değiştirin.
Sayfalamayı özelleştirme veya katılımcı oturumları listesini filtreleme
Katılımcı oturumlarının sayfalandırmasını özelleştirmek veya 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. Belirtilmemesi durumunda en fazla 100 katılımcı oturumu döndürülür. Maksimum değer 250'tir; 250'den yüksek 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ı.participants
kaynak sonuçlarında belirli öğeleri almak için bir sorgu filtresi.Belirli bir zamandan önce katılan veya belirli bir zamandan sonra ayrılan kullanıcıları filtrelemek için
startTime
veyaendTime
alanlarını kullanabilirsiniz. Her iki alan da RFC 3339 UTC "Zulu" biçiminde zaman damgası biçimini kullanır. Bu biçim nanosaniye çözünürlüktedir ve ondalık kısımda dokuz basamağa kadar yer vardı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
simgesini kullanın.