Google Meet REST API'ye genel bakış

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

Meet REST API ile şunları yapabilirsiniz:

  • Kullanıcılarla görüntülü görüşme üzerinden bağlantı kurmak için bir toplantı alanı oluşturun.
  • Kaynak adına göre toplantı alanı veya konferans öğrenebilirsiniz.
  • Katılımcıların ve katılımcı oturumlarının listesini alma.
  • Toplantı yapılarını (kayıtlar, transkriptler ve transkript girişleri) alma.

Google Workspace Etkinlikleri API'sini 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 Google Workspace Etkinlikleri API'sini kullanarak etkinliklere abone olma ve Google Meet etkinliklerine abone olma başlıklı makaleleri inceleyin.

Kullanım alanları

Uygulamalar Meet REST API ile entegre olarak aşağıdaki görevleri gerçekleştirebilir:

  • Konferanstan önce: Toplantı alanı oluşturarak konferans deneyimini ihtiyaca göre özelleştirin. Ayrıca davetlileri yönetebilir ve ayarları önceden yapılandırabilirsiniz.

  • Konferans sırasında: Döndürülen meta verilere göre uygulama deneyiminizi değiştirmek için konferans bilgilerini alın.

  • Konferanstan sonra: Kayıt ve metne dönüştürme gibi konferans yapılarını getirin.

Meet REST API'yi kullanmak isteyebileceğiniz işlemlere birkaç örnek:

  • Satış ve hesap yönetimi

    • Kayıt amacıyla toplantı ve katılımcı bilgilerini alma.
    • Toplantı yapılarını alın ve hesaplarda yayınlayın.
    • Koçluk ve satış verimliliği analizleri oluşturmak için AI modelleri üzerinden metne dönüştürme ve kayıt yapma işlemleri gerçekleştirin.

  • Öğrenme ve gelişim

    • Eğitim için toplantılar oluşturun ve bunları önceden yapılandırın.
    • Eğitmenlere ve oturum liderlerine yardımcı düzenleyen rolü atayın.
    • Öğrencilerin kurs sona erdikten sonra materyalleri incelemelerine olanak tanıyan kayıtları alın.

  • Geliştirici işlemleri

    • Ekip arkadaşlarıyla anında bağlantı kurmak için toplantılar oluşturun.
    • Gerçek zamanlı toplantı ve katılımcı bilgilerini paylaşarak diğer paydaşların devam eden toplantılara katılımını sağlayabilirsiniz.
    • Sonraki adımları doğru şekilde belirlemek için metne dönüştürme verilerini AI modelleri üzerinden çalıştırın.
Chat alanında iş arkadaşlarınızla dinamik toplantılar oluşturun ve toplantılara katılın.
Şekil 1. Chat alanında iş arkadaşlarınızla dinamik toplantılar oluşturun ve toplantılara katılın.

Ortak çalışmayı daha da ileri taşımak için uygulamanıza Chat API gibi diğer Google Workspace API'lerini de dahil edebilirsiniz. Daha fazla bilgi edinmek için Chat kullanım alanları başlıklı makaleyi inceleyin.

Sık kullanılan terimler

Bu API'de yaygın olarak kullanılan terimlerin listesi aşağıda verilmiştir:

Yapı
Bir konferansa yanıt olarak Meet tarafından oluşturulan bir dosya (ör. kayıtlar ve transcripts). Yapılar genellikle konferans sona erdikten kısa bir süre sonra getirilmeye hazırdır.
Takvim etkinliği
Google Takvim'de genellikle bir toplantıyı düzenleyen kişi tarafından oluşturulan ve toplantıya katılma bilgilerini içeren, birden fazla katılımcılı bir etkinlik. Meet, etkinlik için bir konferans çözümü olabilir.
Telefon
Meet'in kullanıldığı bir oturum veya bir görüşmenin başladığını ya da devam ettiğini diğer kullanıcılara bildirip hemen katılmalarına olanak tanımak için.
Konferans
Konferans, toplantı alanında yer alan bir arama örneğidir. Kullanıcılar bu senaryoyu genellikle tek bir toplantı olarak değerlendirir.
Yardımcı düzenleyen
Bir görüşmede bir düzenleyen tarafından ana makine yönetimi ayrıcalıkları verilen (orijinal ana makineyi kaldırma olanağı hariç) bir kişi.
Düzenleyen
Görüşmeyi oluşturan kişi (toplantıyı düzenleyen) veya görüşmeyi kontrol eden kişi. Toplantıyı düzenleyen kişinin toplantıyı organize edebileceğini ancak gerçekleştiğinde toplantıda bulunamayacağını unutmayın. Toplantıyı düzenleyen kullanıcı, barındırıcı ayrıcalıklarını bir yardımcı düzenleyene de atayabilir.
Toplantı kodu
Bir toplantı alanının birleştirme URL'sinde kullanılan, toplantı alanı için kullanılan, yazılabilir ve benzersiz 10 karakterli bir dize. Örneğin, abc-mnop-xyz. Toplantı kodları, toplantı alanından ayrılabileceği ve gelecekte farklı toplantı alanlarında yeniden kullanılabildiği için uzun süre depolanmamalıdır. Toplantı kodlarının süresi genellikle son kullanımdan 365 gün sonra dolar. Daha fazla bilgi edinmek için Google Meet'teki toplantı kodları hakkında bilgi edinme başlıklı makaleyi inceleyin.
Toplantı adı
Toplantı alanını tanımlamak için kullanılan, sunucu tarafından oluşturulan benzersiz bir kimliktir. Toplantı kimliği, bir spaces kaynağının name alanında döndürülür.
Toplantıyı düzenleyen
Toplantı alanını oluşturan kullanıcı. Bu kullanıcı aynı zamanda toplantının sahibi olarak da kabul edilebilir. Bu kullanıcı, görüşme sırasında mevcut olmayabilir veya toplantıyı düzenleyen kişi olmayabilir. Toplantıyı yalnızca bir düzenleyen olabilir.
Toplantı alanı
Konferansın yapıldığı sanal bir yer veya kalıcı nesne (toplantı odası gibi). Tek bir alanda aynı anda yalnızca bir aktif konferans düzenlenebilir. Toplantı alanı, kullanıcıların buluşmasına ve paylaşılan kaynakları bulmasına da yardımcı olur.
Katılımcı
Görüşmeye katılan, Tamamlayıcı Mod'u kullanan, izleyici olarak izleyen veya görüşmeye bağlı bir oda cihazı kullanan bir kullanıcı. Her kişi için bir conferenceRecords.participants kaynağı vardır. Bir katılımcı konferansa katıldığında benzersiz bir kimlik atanır.
Katılımcı oturumu
Görüşmeye katılan her katılımcı-cihaz çifti için oluşturulan benzersiz oturum kimliği. Her oturum için bir conferenceRecords.participants.participantSessions kaynağı vardır. Katılımcı aynı görüşmeye aynı katılımcı-cihaz çiftinden birden fazla kez katılırsa her birine benzersiz oturum kimlikleri atanır.

API'ye özel yetkilendirme ve kimlik doğrulama bilgileri

Yetkilendirme kapsamları, uygulamanızın toplantı içeriğine erişmesi için kullanıcılardan yetkilendirmesini istediğiniz izinlerdir. Birisi uygulamanızı yüklediğinde, kullanıcıdan bu kapsamları doğrulaması istenir. Genel olarak mümkün olan en dar kapsamlı odaklı kapsamı seçmeniz ve uygulamanızın gerektirmediği kapsamları talep etmekten kaçınmanız gerekir. Kullanıcılar sınırlı, net bir şekilde açıklanan kapsamlara daha kolay bir şekilde erişim izni verir.

Meet REST API aşağıdaki OAuth 2.0 kapsamlarını destekler:

Kapsam kodu Açıklama Kullanım
https://www.googleapis.com/auth/meetings.space.readonly Uygulamaların, kullanıcının erişebildiği tüm toplantı alanlarıyla ilgili meta verileri okumasına izin verin. Hassas
https://www.googleapis.com/auth/meetings.space.created Uygulamaların, toplantı alanlarıyla ilgili meta verileri oluşturmasına, değiştirmesine ve okumasına izin verin. Hassas
https://www.googleapis.com/auth/drive.readonly Uygulamaların, Google Drive API'sinden kayıt ve metne dönüştürme dosyalarını indirmesine izin verin. Kısıtlı

Belirli OAuth 2.0 kapsamları hakkında daha fazla bilgi edinmek için Google API'leri için OAuth 2.0 Kapsamları bölümüne bakın.