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 katılan 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 oturuma 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, 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 aşağıdakilerden yalnızca biri olabilir:
signedinUserşunlardan biri olabilir:Kişisel bilgisayardan, mobil cihazdan veya yardımcı mod aracılığıyla 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.phoneUserkullanı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'ya göre büyükten küçüğe sıralanmış şekilde 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. Belirtilmezse 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.participantskaynak 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
earliestStartTimeveyalatestEndTimealanlarını kullanabilirsiniz. Her iki alan da RFC 3339 UTC "Zulu" biçiminde Timestamp biçimini kullanır. Nanosaniye çözünürlüğe ve dokuz kesirli basamağa kadar destekler:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. Örneğin:earliestStartTime < 2023-10-01T15:01:23ZlatestEndTime < 2023-10-01T15:01:23Z
Mevcut bir konferanstaki tüm etkin katılımcıları listelemek için
latestEndTime IS NULLkomutunu 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
participantkaynağındaki kişinin kimliğini ayıklayın. Örneğin,participantkaynağının değericonferenceRecords/abc-123/participants/12345ise People API'nin kimliği12345olur.READ_SOURCE_TYPE_PROFILE,READ_SOURCE_TYPE_CONTACTveREAD_SOURCE_TYPE_OTHER_CONTACTReadSourceTypedeğ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ı oturum 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 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 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.participantskaynak 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
startTimeveyaendTimealanlarını kullanabilirsiniz. Her iki alan da RFC 3339 UTC "Zulu" biçiminde Timestamp biçimini kullanır. Nanosaniye çözünürlüğe ve dokuz kesirli basamağa kadar destekler:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. Örneğin:startTime < 2023-10-01T15:01:23ZendTime < 2023-10-01T15:01:23Z
Konferans kaydındaki tüm etkin katılımcı oturumlarını listelemek için
endTime IS NULLkullanın.