Bu belgede, Google Meet REST API kullanılarak bir konferans tarafından oluşturulan farklı toplantı yapıları hakkında nasıl ayrıntılı bilgi alınacağı açıklanmaktadır.
Yapay nesne, Google Meet'in bir konferansa yanıt olarak oluşturduğu bir dosya veya veridir. Buna video kayıtları ve transkript gibi diğer çıktılar dahildir.
Katılımcıların çıktı oluşturabilmesi için konferans sona ermeden önce Meet'te çıktıları yapılandırması gerekir. Daha fazla bilgi için Otomatik yapay nesneleri yönetme başlıklı makaleyi inceleyin.
Transkriptler kayıtlardan bağımsız olarak çalışır ve transkript oluşturmak için toplantıyı kaydetmeniz gerekmez. Tüm katılımcılar toplantıdan çıktığında transkript otomatik olarak durur. Daha fazla bilgi için Görüntülü toplantı kaydetme ve Google Meet'te Transkriptleri Kullanma başlıklı makaleleri inceleyin.
Yapıları alma
Toplantı alanı sahibi veya katılımcısıysanız get ve list yöntemlerini recordings, transcripts, transcripts.entries ve smart notes kaynaklarında çağırarak yapay nesneleri alabilirsiniz. Daha fazla bilgi için aşağıdaki bölümleri inceleyin.
Kullanıcı kimlik bilgileriyle kimlik doğrulama ve yetkilendirme, 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 işlemi, her kullanıcının tek tek izin vermesine gerek kalmadan 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'si hakkında bilginiz varsa
file
alan değeri, files kaynağındaki
id alanına 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ıtlarla ilgili ayrıntıları alma
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 parent yol parametresiyle recordings kaynağında list yöntemini kullanın. Biçim şöyledir:
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 konferans kaydındaki tüm kayıtların nasıl listeleneceği gösterilmektedir:
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 değerine karşılık gelir.
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 yol 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 parametresini içeren transcripts kaynağında list yöntemini kullanın. Biçim şöyledir:
conferenceRecords/{conferenceRecord}.
Yöntem, startTime ile artan sırada 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 transkribe edilmiş 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 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ı 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 girişi 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 birlikte transcripts.entries kaynağında list yöntemini kullanın. Biçim şöyledir:
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.
Akıllı notlar
Aşağıdaki bölümlerde, konferans kayıtlarındaki konferans akıllı notları hakkında nasıl bilgi edineceğiniz ayrıntılı olarak açıklanmaktadır.
Akıllı not verileri oluşturulduktan sonra Meet, akıllı not kimliğine erişebilir. Kullanıcı, akıllı notlar dosyasını Drive'dan silmiş olabilir ancak benzersiz ad Meet'te gösterilmeye devam eder.
smartNotes kaynağı State nesnesini içerir.
Bu nesne, akıllı notlar oturumunun durumunu tutar. Bu sayede, akıllı notlar oturumunun başlatılıp başlatılmadığını, akıllı notlar oturumunun sona erip ermediğini ancak akıllı notlar dosyasının hazır olup olmadığını veya akıllı notlar dosyasının oluşturulup indirilmeye hazır olup olmadığını sorgulayabilirsiniz.
smartNotes kaynağı, DocsDestination nesne türünü de içerir. Bu nesne, Google Dokümanlar akıllı notlar dosyasının kaydedildiği Drive'daki dışa aktarma konumunu tutar. İçeriği getirmek veya akıllı notlara tarayıcıda göz atmak 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 değerine karşılık gelir.
Akıllı notları get ve list yöntemlerini kullanarak yönetebilirsiniz.
Akıllı notlar hakkında ayrıntılı bilgi edinme
Belirli bir akıllı notlar dosyasıyla ilgili ayrıntıları almak için name yol parametresiyle smartNotes kaynağında get yöntemini kullanın. Akıllı notların adını bilmiyorsanız list yöntemini kullanarak tüm akıllı not dosyalarını listeleyebilirsiniz.
Yöntem, smartNotes kaynağının bir örneğini döndürür.
Tüm akıllı notları listeleme
Bir konferans kaydındaki tüm akıllı notlar dosyalarıyla ilgili ayrıntıları listelemek için parent yol parametresiyle smartNotes kaynağında list yöntemini kullanın. Biçim şöyledir:
conferenceRecords/{conferenceRecord}.
Bu yöntem, smartNotes kaynağının bir örneği olarak, startTime'ya göre artan düzende sıralanmış konferans akıllı notları dosyalarının listesini döndürür. Sayfa boyutunu ayarlamak için Sayfalandırmayı özelleştirme başlıklı makaleyi inceleyin.
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.