Bu kılavuzda, Google Meet REST API'yi kullanarak bir konferans tarafından oluşturulan farklı toplantı yapıları hakkında nasıl ayrıntılı bilgi edineceğiniz açıklanmaktadır.
Yapı, Google Meet'in bir konferansa yanıt olarak oluşturduğu bir dosya veya veridir. Buna videolar ve transkriptler gibi diğer öğeler dahildir.
Çıktı oluşturmak için katılımcıların konferans sona ermeden önce Meet'te çıktı 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'te transkriptleri kullanma başlıklı makaleleri inceleyin.
Toplantı alanı sahibi veya katılımcısıysanız get()
ve list()
yöntemlerini recordings
, transcripts
ve transcripts.entries
kaynaklarında çağırarak yapay nesneleri alabilirsiniz.
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.
Yapı saklama
Bir konferans sona erdikten sonra Meet, kayıtları ve transkriptleri toplantıyı düzenleyen kullanıcının Google Drive'ına kaydeder. Varsayılan olarak Meet yapay nesneleri Drive kurallarına göre saklanır.
Meet REST API tarafından sağlanan transkript girişleri, konferans sona erdikten 30 gün sonra silinir.
Ayrıca, Google Apps Kasası'nda Meet'e özel saklama kurallarını kullanarak Meet çıktılarını ayrı olarak saklayabilirsiniz. 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ıtlar hakkında nasıl bilgi alınacağı ayrıntılı olarak açıklanmaktadır.
Meet, kayıt dosyası oluşturulduktan sonra kayıt kimliğine erişebilir. Kullanıcılar, kayıt dosyasını Google Drive'dan silebilir ancak Meet'te benzersiz ad döndürülmeye 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 tutar. 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 Dosyaları indirme ve dışa aktarma başlıklı makaleyi inceleyin.
State
nesnesi, kayıt oturumunun durumunu tutar. Bu sayede, kaydın başlatılıp başlatılmadığını, kaydı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ıt hakkında ayrıntılı bilgi edinme
Belirli bir kayıtla ilgili ayrıntıları almak için name
yol parametresiyle recordings
kaynağında get()
yöntemini kullanın. Kayıt adını bilmiyorsanız list()
yöntemini kullanarak tüm kayıt adlarını listeleyebilirsiniz.
Yöntem, recordings
kaynağının bir örneğini 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ı, 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 recordings
kaynağında parent
yol parametresiyle list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}
.
Yöntem, startTime
ile artan düzende sıralanmış konferans kayıtlarının listesini recordings
kaynağının bir örneği olarak döndürür. Sayfa boyutunu ayarlamak için Sayfalandırmayı özelleştirme başlıklı makaleye bakın.
Aşağıdaki kod örneğinde, bir konferanstaki tüm kayıtların nasıl listeleneceği gösterilmektedir: record:
Java
Node.js
Python
Üst değeri, konferans kaydının adıyla değiştirin.
Transkriptler
Aşağıdaki bölümlerde, konferans kayıtlarındaki konferans transkriptleri hakkında nasıl bilgi edineceğiniz ayrıntılı olarak açıklanmaktadır.
Meet, transkript verileri oluşturulduktan sonra transkript kimliğine erişebilir. Kullanıcı, transkript dosyasını Drive'dan silmiş olabilir ancak Meet'te benzersiz ad döndürülmeye devam eder.
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 tutar. İçeriği getirmek veya transkripti tarayıcıda incelemek için nesnenin exportUri
alan değerini kullanın. Google Dokümanlar API'si hakkında bilginiz varsa document
alan değeri, documents
kaynağındaki documentId
ile eşleşir.
State
nesnesi, transkript oturumunun durumunu tutar. 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ı veya transkript dosyasının oluşturulup indirilmeye hazır olup olmadığını sorgulayabilirsiniz.
Transkript hakkında ayrıntılı bilgi edinme
Belirli bir transkriptle ilgili ayrıntıları almak için name
yolu parametresiyle transcripts
kaynağında get()
yöntemini kullanın. Transkript adını bilmiyorsanız list()
yöntemini kullanarak tüm transkript adlarını listeleyebilirsiniz.
Yöntem, transcripts
kaynağının bir örneğini 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ı, 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 parametresine sahip transcripts
kaynağında list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}
.
Yöntem, startTime
ile artan düzende sıralanmış konferans transkriptlerinin listesini transcripts
kaynağının bir örneği olarak döndürür. Sayfa boyutunu ayarlamak için Sayfalandırmayı özelleştirme başlıklı makaleye bakın.
Aşağıdaki kod örneğinde, bir konferans kaydındaki tüm transkriptlerin nasıl listeleneceği gösterilmektedir:
Java
Node.js
Python
Üst değeri, 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 transkriptini içeren metni (en fazla 10.000 kelime) içerir. Konuşulan metin languageCode
(örneğin, en-US
) IETF BCP 47 söz dizimi olarak da eklenir.
Her transkript girişi, konferanstaki bir participant
adına bağlanır. Katılımcı ayrıntılarını almak için Katılımcılar hakkında ayrıntılı bilgi edinme başlıklı makaleyi inceleyin.
Transkript girişi verileri, konferans sona erdikten sonraki 30 gün boyunca kullanılabilir.
Meet REST API tarafından döndürülen transkript girişlerinin, Dokümanlar transkript dosyasındaki transkriptle eşleşmeyebileceğini unutmayın. Bu durum, transkript dosyası oluşturulduktan sonra değiştirildiğinde ortaya çıkar.
Transkript girişi hakkında ayrıntılı bilgi edinme
Belirli bir transkript girişiyle ilgili ayrıntıları almak için name
yol parametresiyle transcripts.entries
kaynağında get()
yöntemini kullanın. Transkript girişi adını bilmiyorsanız list()
yöntemini kullanarak tüm transkript adlarını listeleyebilirsiniz.
Yöntem, transcripts.entries
kaynağının bir örneğini 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 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 parametresiyle transcripts.entries
kaynağında list()
yöntemini kullanın. Biçim:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
.
Bu yöntem, startTime
kaynağının bir örneği olarak, konferans transkripti başına yapılandırılmış transkript girişlerinin bir listesini döndürür. Bu liste, startTime
sütununa göre artan düzende sıralanır.transcripts.entries
Sayfa boyutunu ayarlamak için Sayfalandırmayı özelleştirme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, bir transkriptteki tüm transkript girişlerinin nasıl listeleneceği gösterilmektedir:
Java
Node.js
Python
Üst değeri, konferans kaydının adı ve transkript adıyla değiştirin.
Sayfalara ayırma işlemini özelleştirme
Kayıtların, transkriptlerin ve transkript girişlerinin sayfalara ayrılması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'e 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
- Yönetici olarak Meet özelliklerini özelleştirme