Bu kılavuzda, Google Meet REST API'si kullanılarak bir konferans tarafından oluşturulan farklı toplantı yapılarıyla ilgili ayrıntıların nasıl alınacağı açıklanmaktadır.
Yapı, Google Meet tarafından bir konferans'a yanıt olarak oluşturulan dosya veya veridir. Videolar ve transkriptler gibi diğer öğeler de bu kapsamdadır.
Katılımcıların yapı oluşturmak için konferans sona ermeden önce Meet'te yapı oluşturması gerekir. Transkriptler kayıtlardan bağımsız olarak çalışır ve transkript oluşturmak için toplantıyı kaydetmeniz gerekmez. Daha fazla bilgi için Görüntülü toplantıyı kaydetme ve Google Meet ile transkriptleri kullanma başlıklı makaleleri inceleyin.
Toplantı alanı sahibi veya katılımcısıysanız yapıları almak için recordings
, transcripts
ve transcripts.entries
kaynaklarındaki 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.
Yapı saklama
Meet, bir konferans sona erdiğinde kayıtları ve transkriptleri toplantıyı düzenleyen kullanıcının Google Drive'ına kaydeder. Meet yapıları varsayılan olarak Drive kurallarına göre saklanır.
Meet REST API tarafından sağlanan transkript girişleri, konferansın sona ermesinden 30 gün sonra silinir.
Ayrıca, Google Apps Kasası'ndaki Meet'e özel saklama kurallarını kullanarak Meet yapılarının saklanmasını ayrı olarak yönetebilirsiniz. Daha fazla bilgi için Apps Kasası'nı kullanarak Google Meet verilerini saklama başlıklı makaleyi inceleyin.
Kayıtlar
Aşağıdaki bölümlerde, konferans kaydındaki kayıtlarla ilgili bilgilerin nasıl alınacağı ayrıntılı olarak açıklanmıştır.
Kayıt dosyası oluşturulduktan sonra Meet, kayıt kimliğine erişebilir. Kullanıcılar kayıt dosyasını Google Drive'dan silebilir ancak benzersiz ad Meet'te gösterilmeye devam edebilir.
recordings
kaynağı hem DriveDestination
hem de State
nesnelerini içerir.
DriveDestination
nesnesi, kaydın MP4 dosyası olarak kaydedildiği Drive'daki dışa aktarma konumunu içerir. Kaydı indirmek veya tarayıcıda oynatmak için nesnenin exportUri
alan değerini kullanın. Google Drive API'yi biliyorsanız file
alan değeri, files
kaynağındaki id
değerine karşılık gelir. Daha fazla bilgi için Dosya indirme ve dışa aktarma başlıklı makaleyi inceleyin.
State
nesnesi, kayıt oturumunun durumunu içerir. Bu sayede, kaydın başlatılıp başlatılmadığını, bitip bitmediğini ancak kayıt dosyasının hazır olup olmadığını veya kayıt dosyasının oluşturulup indirilmeye hazır olup olmadığını sorgulayabilirsiniz.
Kayıtlarla ilgili ayrıntıları alma
Belirli bir kayıtla ilgili ayrıntıları almak için name
yol parametresini kullanarak recordings
kaynağındaki get()
yöntemini kullanın. Kayıt adını bilmiyorsanız list()
yöntemini kullanarak tüm kayıt adlarını listeleyebilirsiniz.
Yöntem, bir recordings
kaynağı örneği döndürür.
Aşağıdaki kod örneğinde, belirli bir kaydın nasıl alınacağı gösterilmektedir:
Java
Node.js
Python
Kayıt adını, bir konferans kaydındaki belirli kayıt kimliğinin adıyla değiştirin.
Tüm kayıtları listeleme
Bir konferans kaydındaki tüm kayıtlarla ilgili ayrıntıları listelemek için parent
yol parametresini kullanarak recordings
kaynağındaki list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}
.
Yöntem, recordings
kaynağının bir örneği olarak startTime
'ye göre artan düzende sıralanmış konferans kayıtlarının listesini döndürür. Sayfa boyutunu ayarlamak için Sayfalandırmayı özelleştirme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, bir konferans kaydındaki tüm kayıtların nasıl listeleneceği gösterilmektedir:
Java
Node.js
Python
Üst öğe değerini konferans kaydının adıyla değiştirin.
Transkriptler
Aşağıdaki bölümlerde, bir konferans kaydındaki konferans transkriptleri hakkında nasıl bilgi edinileceği ayrıntılı olarak açıklanmıştır.
Transkript verileri oluşturulduktan sonra Meet, transkript kimliğine erişebilir. Kullanıcılar transkript dosyasını Drive'dan silebilir ancak Meet'te benzersiz ad yine de döndürülebilir.
transcripts
kaynağı hem DocsDestination
hem de State
nesnelerini içerir.
DocsDestination
nesnesi, Google Dokümanlar transkript dosyasının kaydedildiği Drive'daki dışa aktarma konumunu içerir. İçeriği almak veya transkripte tarayıcıda göz atmak için nesnenin exportUri
alan değerini kullanın. Google Dokümanlar API'sini biliyorsanız document
alan değeri, documents
kaynağındaki documentId
değerine karşılık gelir.
State
nesnesi, transkript oturumunun durumunu içerir. Bu sayede transkript oturumunun başlatılıp başlatılmadığını, transkript oturumunun sona erip ermediğini ancak transkript dosyasının hazır olup olmadığını ya da transkript dosyasının oluşturulup indirilmeye hazır olup olmadığını sorgulayabilirsiniz.
Transkriptlerle ilgili ayrıntıları alma
Belirli bir transkriptle ilgili ayrıntıları almak için name
yol parametresini kullanarak transcripts
kaynağındaki get()
yöntemini kullanın. Transkript adını bilmiyorsanız list()
yöntemini kullanarak tüm transkript adlarını listeleyebilirsiniz.
Yöntem, bir transcripts
kaynağı örneği döndürür.
Aşağıdaki kod örneğinde, belirli bir transkriptin nasıl alınacağı gösterilmektedir:
Java
Node.js
Python
Transkript adını, bir konferans kaydındaki belirli transkript kimliğinin adıyla değiştirin.
Tüm transkriptleri listeleme
Bir konferans kaydındaki tüm transkriptlerle ilgili ayrıntıları listelemek için parent
yol parametresini kullanarak transcripts
kaynağındaki list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}
.
Yöntem, transcripts
kaynağının bir örneği olarak startTime
değerine göre artan düzende sıralanmış konferans transkriptlerinin listesini döndürür. Sayfa boyutunu ayarlamak için Sayfalandırmayı özelleştirme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, bir konferans kaydındaki tüm transkriptlerin nasıl listeleneceği gösterilmektedir:
Java
Node.js
Python
Üst öğe değerini konferans kaydının adıyla değiştirin.
Transkript girişleri
Aşağıdaki bölümlerde, konferans transkripti oturumu sırasında her katılımcının konuşmasının transkript girişleri olarak nasıl alınacağı ayrıntılı olarak açıklanmaktadır.
Transkript girişi, katılımcının sesinin transkript metnini içerir. Bu metin en fazla 10.000 kelime olabilir. Konuşulan metin languageCode
(örneğin, en-US
) IETF BCP 47 söz dizimi olarak da dahil edilir.
Her transkript girişi, konferanstaki bir participant
adına bağlıdır. Katılımcı ayrıntılarını almak için Katılımcı hakkında ayrıntılı bilgi edinme başlıklı makaleyi inceleyin.
Transkript giriş verileri, konferans sona erdikten sonraki 30 gün boyunca kullanılabilir.
Meet REST API tarafından döndürülen transkript girişlerinin, Docs transkript dosyasında bulunan transkriptle eşleşmeyebileceğini unutmayın. Bu durum, transkript dosyası oluşturulduktan sonra değiştirildiğinde ortaya çıkar.
Transkript girişiyle ilgili ayrıntıları alma
Belirli bir transkript girişiyle ilgili ayrıntıları almak için name
yol parametresini kullanarak transcripts.entries
kaynağındaki get()
yöntemini kullanın. Transkript giriş adını bilmiyorsanız list()
yöntemini kullanarak tüm transkript adlarını listeleyebilirsiniz.
Yöntem, bir transcripts.entries
kaynağı örneği döndürür.
Aşağıdaki kod örneğinde, belirli bir transkript girişinin nasıl alınacağı gösterilmektedir:
Java
Node.js
Python
Transkript girişi adını, transkriptteki belirli bir transkript girişi kimliğinin adıyla değiştirin.
Tüm transkript girişlerini listeleme
Bir transkriptteki tüm transkript girişleriyle ilgili ayrıntıları listelemek için parent
yol parametresini kullanarak transcripts.entries
kaynağındaki list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Yöntem, transcripts.entries
kaynağının bir örneği olarak konferans transkripti başına yapılandırılmış transkript girişlerinin listesini startTime
sütununa göre artan düzende döndürür. Sayfa boyutunu ayarlamak için Sayfalandırmayı özelleştirme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, transkriptteki tüm transkript girişlerinin nasıl listeleneceği gösterilmektedir:
Java
Node.js
Python
Üst öğe değerini, konferans kaydının ve transkriptin adıyla değiştirin.
Sayfalara ayırma işlemini özelleştirme
Kayıtların, transkriptlerin ve transkript girişlerinin sayfalandırmasını özelleştirmek için aşağıdaki sorgu parametrelerini iletin:
pageSize
: İade edilecek maksimum öğe sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemesi halinde en fazla 10 öğe döndürülür. Maksimum değer 100'dür; 100'den büyük değerler otomatik olarak 100 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.
İlgili konular
- Görüntülü toplantıyı kaydetme
- Google Meet ile Transkript özelliğini kullanma
- Apps Kasası'nı kullanarak Google Meet verilerini saklama
- Meet özelliklerini yönetici olarak özelleştirme