Google Meet REST API'ye genel bakış

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

Meet REST API ile şunları yapabilirsiniz:

  • Kullanıcılarla görüntülü görüşme gerçekleştirmek için bir toplantı alanı oluşturun.
  • Kaynak adına göre bir toplantı alanı veya konferans alın.
  • 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) alabilirsiniz.

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

Kullanım alanları

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

  • Konferanstan önce: Toplantı alanını oluşturarak konferans deneyimini gerektiği gibi ö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.

Aşağıda, Meet REST API'yi kullanmak isteyebileceğiniz noktalara birkaç örnek verilmiştir:

  • Satış ve hesap yönetimi

    • Kayıt amacıyla toplantı ve katılımcı bilgilerini alma.
    • Toplantı yapılarını getirin ve hesaplarda yayınlayın.
    • Koçluk ve satışların etki düzeyi analizleri oluşturmak için metne dönüştürmeleri ve kayıtları AI modelleri aracılığıyla çalıştırın.

  • Öğrenme ve gelişim

    • Eğitim için toplantılar oluşturun ve önceden yapılandırın.
    • Eğitmenlere ve oturumun potansiyel müşterilerine yardımcı düzenleyen rolleri atayın.
    • Öğrencilerin ders sona erdikten sonra materyalleri gözden geçirmesine olanak tanıyan kayıtları alın.

  • Geliştirici işlemleri

    • Ekip arkadaşlarınızla 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 sürekli toplantılara katılmasına izin verin.
    • Sonraki doğru adımları oluşturmak için metne dönüştürme verilerini AI modelleri aracılığıyla çalıştırın.
Chat alanında iş arkadaşlarınızla dinamik toplantılar oluşturup bu toplantılara katılabilirsiniz.
Şekil 1. Chat alanında iş arkadaşlarınızla dinamik toplantılar oluşturup bu toplantılara katılabilirsiniz.

Ortak çalışmayı daha da ileri taşımak için uygulamanıza Chat API gibi diğer Google Workspace API'lerini de ekleyebilirsiniz. Daha fazla bilgi için Chat kullanım alanları bölümünü inceleyin.

Sık kullanılan terimler

Aşağıda, bu API'de kullanılan genel terimlerin listesi yer almaktadır:

Yapı
Meet tarafından konferanslar (ör. kayıtlar ve transcripts) sonucunda oluşturulan dosyalar. Genellikle bir yapı, konferans sona erdikten hemen sonra getirilmeye hazır olur.
Takvim etkinliği
Google Takvim'de, genellikle toplantıyı düzenleyen bir kişi tarafından oluşturulan ve toplantıya katılma bilgilerini içeren, birden fazla katılımcının yer aldığı bir etkinliktir. Meet, etkinlik için konferans çözümü olabilir.
Telefon
Meet kullanarak bir oturum açma veya diğer kullanıcılara bir görüşmenin başladığını ya da devam ettiğini bildirme ve kullanıcıların hemen katılmalarına olanak tanıma.
Konferans
Konferans, bir toplantı alanındaki aramaya örnektir. Kullanıcılar genellikle bu senaryoyu tek bir toplantı olarak değerlendirir.
Yardımcı
Bir görüşmede, barındırıcı tarafından düzenleyen kullanıcı yönetimi ayrıcalıkları verilen (asıl düzenleyeni kaldırma yetkisi dışında) bir kişi.
Düzenleyen
Görüşme oluşturan kullanıcı (toplantıyı düzenleyen) veya görüşmeyi kontrol eden kullanıcı. Toplantıyı düzenleyen kişinin toplantıyı organize edebileceğini ancak toplantı esnasında toplantıya katılmadığını unutmayın. Ayrıca düzenleyen, yardımcı düzenleyene düzenleyen ayrıcalıkları da verebilir.
Toplantı kodu

Toplantı alanının toplantı URI'si içinde kullanılan, toplantı alanı için 10 karakterlik, yazılabilir bir dizedir. Kimlik, büyük/küçük harfe duyarlı değildir. Örneğin, abc-mnop-xyz. En çok 128 karakter kullanılabilir.

Toplantı kodları, toplantı alanından ayrılabileceği ve gelecekte farklı toplantı alanlarında yeniden kullanılabileceğ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ı alanlarını tanımlamak için kullanılan, sunucu tarafından oluşturulan benzersiz bir 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.

Toplantıyı düzenleyen

Toplantı alanını oluşturan kullanıcı. Bu kullanıcı, toplantının sahibi olarak da kabul edilebilir. Bu kullanıcı, arama sırasında mevcut olmayabilir veya toplantıyı düzenleyen kişi olabilir. Yalnızca bir toplantıyı düzenleyen kişi olabilir.

Toplantı alanı

Konferans yapılan sanal bir yer veya kalıcı nesne (ör. toplantı odası). Tek bir alanda aynı anda yalnızca bir etkin konferans düzenlenebilir. Toplantı alanı, kullanıcıların bir araya gelerek ortak kaynakları bulmalarına da yardımcı olur.

Toplantı URI'si

Bir kullanıcıyı başlatan veya bir çağrıya ekleyen tıklanabilir URL. Her çağrının, https://meet.google.com/ ve ardından toplantı kodu içeren benzersiz bir URL'si vardır. Örneğin, https://meet.google.com/abc-mnop-xyz.

Katılımcı

Görüşmeye katılan veya Tamamlayıcı Mod'u kullanan, izleyici olarak izleyen ya da görüşmeye bağlı bir oda cihazı olan bir kullanıcı. Her kullanıcı için bir conferenceRecords.participants kaynak vardır. Konferansa bir katılımcı 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 kaynak vardır. Katılımcı, aynı katılımcı-cihaz çiftinden aynı görüşmeye 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 yetkilendirmelerini istediğiniz izinlerdir. Bir kullanıcı uygulamanızı yüklediğinde bu kapsamları doğrulaması istenir. Genel olarak, mümkün olduğunca dar bir alana odaklanan kapsamı seçmeli ve uygulamanızın gerektirmediği kapsamları istemekten kaçınmalısınız. Kullanıcılar sınırlı, net bir şekilde açıklanan kapsamlara daha kolay 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 Uygulamalara, kullanıcının erişebildiği tüm toplantı alanları hakkındaki meta verileri okuma izni verin. Hassas
https://www.googleapis.com/auth/meetings.space.created Uygulamalara, uygulamanız tarafından oluşturulan toplantı alanlarıyla ilgili meta verileri oluşturma, değiştirme ve okuma izni verin. Hassas
https://www.googleapis.com/auth/drive.readonly Uygulamaların, kayıt ve transkript dosyalarını Google Drive API'den 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.