Google Meet REST API'ye genel bakış

Google Meet REST API, Google Meet için toplantılar oluşturmanıza ve yönetmenize olanak tanır. Ayrıca, kullanıcılarınıza doğrudan uygulamanızdan giriş noktaları sunar.

Meet REST API ile şunları yapabilirsiniz:

  • Kullanıcıları video üzerinden bağlamak için toplantı alanları oluşturun ve yapılandırın.
  • Alan erişim düzeylerini, moderasyon ayarlarını ve otomatik kayıtları veya transkriptleri önceden yapılandırın.
  • Toplantı alanı üyelerini yönetme ve yardımcı düzenleyen rolleri atama
  • Bir toplantı alanında etkin bir konferansı programatik olarak sonlandırma.
  • Konferans kayıtlarını, katılım ayrıntılarını ve katılımcı oturumu meta verilerini alma
  • Toplantı çıktılarını (kayıtlar, transkriptler, transkript girişleri ve akıllı notlar) alma

Google Workspace Events API'yi kullanarak da Meet etkinliklerine abone olabilirsiniz. Değişikliklerden haberdar olmak için belirli bir toplantı alanına veya belirli bir kullanıcıya ait tüm toplantı alanlarına abone olabilirsiniz. Daha fazla bilgi için aşağıdaki sayfaları inceleyin:

Kullanım alanları

Uygulamalar, aşağıdaki görevleri gerçekleştirmek için Meet REST API ile entegre olabilir:

  • Konferanstan önce: İsteğe bağlı olarak toplantı alanları oluşturun, erişim kısıtlamalarını (açık, güvenilir veya kısıtlanmış) önceden yapılandırın, moderasyon kontrollerini (ekran paylaşımı, sohbet, tepkiler, mikrofon ve kamera) uygulayın, otomatik kaydı veya otomatik transkripti yapılandırın ve alan üyelerine yardımcı düzenleyen rolleri atayın.

  • Konferans sırasında: Google Workspace Events API'yi kullanarak etkin konferans meta verilerini ve katılımcı oturumlarını alın, üyeleri dinamik olarak yönetin, gerçek zamanlı yaşam döngüsü etkinliklerini dinleyin veya etkin konferansı programatik olarak sonlandırın.

  • Konferanstan sonra: Konferans kayıtlarını ve katılım günlüklerini alın, kayıtları, Google Dokümanları transkriptlerini ve akıllı notları Google Drive'dan indirin ve koçluk, uyumluluk veya yapay zeka analizi için ayrıntılı transkript konuşma girişlerine erişin.

Meet REST API'yi kullanmak isteyebileceğiniz bazı örnekler şunlardır:

  • Satış ve hesap yönetimi

    • Kayıt amacıyla toplantı ve katılımcı bilgilerini alma
    • Toplantı çıktılarını getirip hesaplarda yayınlayın.
    • Koçluk ve satış etkinliği analizi oluşturmak için transkriptleri ve kayıtları yapay zeka modellerinden geçirin.

  • Öğrenme ve gelişim

    • Eğitim için toplantılar oluşturun ve önceden yapılandırın.
    • Eğitmenlere ve oturum yöneticilerine yardımcı düzenleyen rolleri atayın.
    • Öğrencilerin kurs bittikten sonra materyalleri incelemesine olanak tanıyan kayıtları alın.

  • Müşteri desteği ve danışmanlık

    • Doğrudan yardım masası kayıtlarından veya müşteri portallarından güvenli ve kısıtlanmış toplantı alanları oluşturun.
    • Düzenleyen kullanıcı yönetimi ayarını önceden yapılandırarak yalnızca destek temsilcilerinin sunum yapabilmesini veya katılımı yönetebilmesini sağlayın.
    • Kalite kontrolü ve uygunluk kayıtları için otomatik kaydetme veya metne dönüştürme özelliğini etkinleştirin.
    • Randevular veya destek oturumları sona erdiğinde etkin konferansları programatik olarak sonlandırın.

  • Geliştirici işlemleri

    • Ekip arkadaşlarınızla anında bağlantı kurmak için toplantılar oluşturun.
    • Anlık toplantı ve katılımcı bilgilerini paylaşarak diğer paydaşların devam eden toplantılara katılmasını sağlayın.
    • Doğru sonraki adımları oluşturmak için transkripsiyon verilerini yapay zeka modellerinden geçirin.
Chat alanında iş arkadaşlarınızla dinamik bir toplantı oluşturun ve toplantıya katılın.
Şekil 1. Chat alanında iş arkadaşlarınızla dinamik bir toplantı oluşturun ve toplantıya katılın.

Ayrıca, işbirliğini daha da ileriye taşımak için Chat API gibi diğer Google Workspace API'lerini de uygulamanıza dahil edebilirsiniz. Daha fazla bilgi için Chat kullanım alanları başlıklı makaleyi inceleyin.

Sık kullanılan terimler

Bu API'de kullanılan yaygın terimlerin listesini aşağıda bulabilirsiniz:

Etkin konferans
Toplantı alanında devam eden konferans. Herhangi bir zamanda bir toplantı alanında yalnızca bir etkin konferans düzenlenebilir. Bittiğinde geçmiş konferans kaydı olur.
Artifact
Meet'in konferansa yanıt olarak oluşturduğu bir dosya (ör. recordings,transcripts ve smartNotes). Yapılar, toplantıyı düzenleyen kullanıcının Drive'ına kaydedilir. Genellikle konferans sona erdikten kısa süre sonra alınmaya hazır olur.
Takvim etkinliği
Genellikle bir toplantı düzenleyicisi tarafından oluşturulan ve toplantının katılma bilgilerini içeren, Google Takvim'deki birden fazla katılımcılı bir etkinlik. Meet, etkinliğin konferans çözümü olabilir.
Telefon
Meet'in kullanıldığı bir oturum veya diğer kullanıcıları görüşmenin başladığı ya da devam ettiği konusunda bilgilendirmek ve hemen katılmalarına izin vermek için kullanılır.
Yardımcı düzenleyen
Bir görüşmede, asıl düzenleyeni kaldırma özelliği hariç olmak üzere düzenleyen tarafından düzenleyen yönetimi ayrıcalıkları verilmiş kişi.
Konferans
Konferans, toplantı alanındaki bir görüşme örneğidir. Kullanıcılar genellikle bu senaryoyu tek bir toplantı olarak değerlendirir.
Konferans kaydı
Her konferans örneği için benzersiz bir kimlik. Konferans başladığında otomatik olarak oluşturulur. The conferenceRecords resource uses the format conferenceRecords/{conferenceRecord}. Örneğin, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Telefonla katılma
Aramaya katılmak veya yayınlanan bir aramayı dinlemek için telefon kullanma.
Düzenleyen
Görüşme oluşturan (toplantıyı düzenleyen) veya görüşmeyi kontrol eden kişi. Toplantıyı düzenleyen kişinin toplantıyı düzenleyebileceğini ancak toplantı sırasında orada bulunmayabileceğini unutmayın. Toplantıyı düzenleyen kullanıcı, düzenleyen ayrıcalıklarını bir yardımcı düzenleyene de devredebilir.
Toplantı kodu

Bir toplantı alanının toplantı URI'sinde kullanılan, yazılabilir ve benzersiz 10 karakterlik toplantı alanı dizesi. Büyük/küçük harfe duyarlı değildir. Örneğin, abc-mnop-xyz. Maksimum uzunluk 128 karakterdir.

Toplantı kodları, toplantı alanıyla ilişkilendirilmeyebileceği ve gelecekte farklı toplantı alanları için yeniden kullanılabileceği için uzun süre saklanmamalıdır. Toplantı kodlarının süresi genellikle son kullanımdan 365 gün sonra sona erer. Daha fazla bilgi için Google Meet'teki toplantı kodları hakkında bilgi başlıklı makaleyi inceleyin.

Toplantı adı

Toplantı alanını tanımlamak için kullanılan, sunucu tarafından oluşturulan benzersiz kimlik. Büyük/küçük harfe duyarlıdır. Örneğin, jQCFfuBOdN5z. Toplantı kimliği, spaces kaynağının name alanında döndürülür. Daha fazla bilgi için Meet, toplantı alanlarını nasıl tanımlar? başlıklı makaleyi inceleyin.

Toplantıyı düzenleyen

Toplantı alanını oluşturan kullanıcı. Bu kullanıcı, toplantı sahibi olarak da kabul edilebilir. Bu kullanıcılar görüşme sırasında mevcut olmayabilir veya toplantının sahibi olmayabilir. Yalnızca bir toplantı düzenleyici olabilir.

Toplantı alanı

Konferansın yapıldığı sanal yer veya kalıcı nesne (ör. toplantı odası). Bir alanda herhangi bir zamanda yalnızca bir etkin konferans düzenlenebilir. Toplantı alanı, kullanıcıların buluşmasına ve paylaşılan kaynakları bulmasına da yardımcı olur.

Toplantı URI'si

Kullanıcıyı arama başlatmaya veya aramaya katılmaya yönlendiren tıklanabilir URL. Her görüşmenin, https://meet.google.com/ ile başlayan ve ardından toplantı kodu ile devam eden benzersiz bir URL'si vardır. Örneğin, https://meet.google.com/abc-mnop-xyz.

Üye

Belirlenmiş bir rolle (ör. COHOST) toplantı alanına açıkça eklenen kullanıcı. Yalnızca canlı konferans sırasında bulunan bir katılımcıdan farklı olarak, üye kalıcı toplantı alanıyla ilişkilendirilir ve bu alandaki birden fazla konferansta ayrıcalıklarını korur.

Katılımcı

Bir görüşmeye katılan veya Tamamlayıcı Mod'u kullanarak izleyici olarak izleyen bir kişi ya da bir görüşmeye bağlı olan bir oda cihazı. Her kişi için bir participants kaynak vardır. Bir katılımcı konferansa katıldığında benzersiz bir kimlik atanır.

Katılımcı oturumu

Bir görüşmeye katılan her katılımcı-cihaz çifti için oluşturulan benzersiz oturum kimliği. Her oturum için bir participantSessions kaynağı bulunur. Katılımcı, aynı görüşmeye aynı katılımcı-cihaz çiftinden birden fazla kez katılırsa her biri için benzersiz oturum kimlikleri atanır.

Kayıt

Konferans kaydedildiğinde oluşturulan MP4 video dosyası ve ilişkili meta veriler. Kayıtlar, toplantıyı düzenleyen kullanıcının Drive'ına kaydedilir ve toplantı yapıları olarak alınabilir.

SIP adresi

Oturum Başlatma Protokolü (SIP) adresi, üçüncü taraf video konferans donanımının Meet konferansını nasıl bulup katılabileceğini ayrıntılı olarak açıklar. Meet, SIP URI şemasını destekler.

Akıllı not

Gemini tarafından oluşturulan ve toplantı düzenleyicinin Drive'ına Dokümanlar dosyası olarak aktarılan konferanstaki önemli noktaların ve yapılacak işlerin kısa bir özeti.

Transkript

Konferansta yapılan sözlü görüşmeyi kaydeden bir metin dokümanı, Dokümanlar dosyası olarak toplantıyı düzenleyen kullanıcının Drive'ına aktarılır.

Transkript girişi

Bir konferanstaki katılımcının transkribe edilmiş konuşmasının ayrı bir bölümü. Her giriş; katılımcı kimliğini, zaman damgasını, konuşulan metni ve dil kodunu içerir. Girişler, konferans sona erdikten sonraki 30 gün boyunca kullanılabilir.