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'yi biliyorsanız 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ıt hakkında ayrıntılı bilgi edinme
Belirli bir kayıtla ilgili ayrıntıları almak için recordings kaynağında get yöntemini kullanın. name yol parametresini conferenceRecords/{conferenceRecord}/recordings/{recordingName} biçimini kullanarak ayarlayı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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/recordings/RECORDING_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN kısmını API'ye erişim izni veren erişim jetonuyla değiştirin.
Aşağıdakini değiştirin:
- Konferans kaydındaki belirli konferans kimliğinin adını içeren konferans kaydı adı.
- Konferans kaydındaki belirli kayıt kimliğinin adını içeren kayıt adı.
Tüm kayıtları listeleme
Bir konferans kaydındaki tüm kayıtlarla ilgili ayrıntıları listelemek için recordings kaynağında list yöntemini kullanın. parent yol parametresini conferenceRecords/{conferenceRecord} biçimini kullanarak ayarlayın.
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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/recordings" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN kısmını API'ye erişim izni veren erişim jetonuyla değiştirin.
Üst adı, konferans kaydındaki belirli konferans kimliğinin 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 transcripts kaynağında get yöntemini kullanın. name yol parametresini conferenceRecords/{conferenceRecord}/transcripts/{transcriptName} biçimini kullanarak ayarlayı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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN kısmını API'ye erişim izni veren erişim jetonuyla değiştirin.
Aşağıdakini değiştirin:
- Konferans kaydındaki belirli konferans kimliğinin adını içeren konferans kaydı adı.
- Konferans kaydındaki belirli transkript kimliğinin adını içeren transkript adı.
Tüm transkriptleri listeleme
Bir konferans kaydındaki tüm transkriptlerle ilgili ayrıntıları listelemek için transcripts kaynağında list yöntemini kullanın. parent yol parametresini conferenceRecords/{conferenceRecord} biçimini kullanarak ayarlayın.
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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN kısmını API'ye erişim izni veren erişim jetonuyla değiştirin.
Üst adı, konferans kaydındaki belirli konferans kimliğinin 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 transcripts.entries kaynağında get yöntemini kullanın. name yol parametresini conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName} biçimini kullanarak ayarlayı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
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME/entries/TRANSCRIPT_ENTRY_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN kısmını API'ye erişim izni veren erişim jetonuyla değiştirin.
Aşağıdakini değiştirin:
- Konferans kaydındaki belirli konferans kimliğinin adını içeren konferans kaydı adı.
- Konferans kaydındaki belirli transkript kimliğinin adını içeren transkript adı.
- Transkriptteki belirli transkript girişi kimliğinin adını içeren transkript girişi adı.
Tüm transkript girişlerini listeleme
Bir transkriptteki tüm transkript girişleriyle ilgili ayrıntıları listelemek için
list
yöntemini
transcripts.entries
kaynağında kullanın. parent yol parametresini conferenceRecords/{conferenceRecord}/transcripts/{transcript} biçimini kullanarak ayarlayın.
Bu yöntem, startTime sütununa göre artan düzende sıralanmış, konferans transkripti başına yapılandırılmış transkript girişlerinin listesini transcripts.entries kaynağının bir örneği olarak 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 transkriptteki tüm transkript girişlerinin nasıl listeleneceği gösterilmektedir:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts/TRANSCRIPT_NAME/entries" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN kısmını API'ye erişim izni veren erişim jetonuyla değiştirin.
Aşağıdakini değiştirin:
- Bir konferans kaydındaki belirli konferans kimliğinin adını içeren üst ad.
- Konferans kaydındaki belirli transkript kimliğinin adını içeren transkript adı.
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 silebilir ancak Meet'te benzersiz ad döndürülmeye devam edebilir.
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ı hakkında ayrıntılı bilgi edinmek için get yöntemini kullanın. smartNotes name yol parametresini conferenceRecords/{conferenceRecord}/smartNotes/{smartNote} biçimini kullanarak ayarlayın.
Akıllı notun 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.
cURL
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/CONFERENCE_RECORD_NAME/smartNotes/SMART_NOTES_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
Aşağıdakini değiştirin:
- CONFERENCE_RECORD_NAME: Bir konferans kaydındaki belirli konferans kimliği.
- SMART_NOTES_NAME: Konferans kaydındaki belirli akıllı not kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
Tüm akıllı notları listeleme
Bir konferans kaydındaki tüm akıllı notlar dosyalarıyla ilgili ayrıntıları listelemek için smartNotes kaynağında list yöntemini kullanın. parent yol parametresini conferenceRecords/{conferenceRecord} biçimini kullanarak ayarlayın.
Bu yöntem, startTime göre artan düzende sıralanmış konferans akıllı notları dosyalarının listesini smartNotes kaynağının bir örneği olarak döndürür. Sayfa boyutunu ayarlamak için Sayfalandırmayı özelleştirme başlıklı makaleyi inceleyin.
cURL
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/PARENT_NAME/smartNotes" \
-H "Authorization: Bearer ACCESS_TOKEN"
Aşağıdakini değiştirin:
- PARENT_NAME: Konferans kaydındaki belirli konferans kimliği.
- ACCESS_TOKEN: API'ye erişim izni veren erişim jetonu.
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.