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 bir toplantı alanı oluşturun.
  • Kaynak adına göre toplantı alanı veya konferans ayarlayabilirsiniz.
  • Katılımcıların ve katılımcı oturumlarının listesini alma
  • Toplantı çıktılarını (kayıtlar, transkriptler ve transkript girişleri) 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: Toplantı alanı oluşturarak konferans deneyimini gerektiği gibi uyarlayın. 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 transkript gibi konferans verilerini getirin.

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ı alıp hesaplarda yayınlayın.
    • Eğitim ve satış etkinliği analizleri 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.

  • 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 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.

İşbirliğini daha da ileriye taşımak için uygulamanıza Chat API gibi diğer Google Workspace API'lerini de 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:

Artifact
Meet'in konferansa yanıt olarak oluşturduğu bir dosya (ör. recordings ve transcripts). Yapay nesneler, toplantıyı düzenleyen kullanıcının Google Drive'ına kaydedilir. Genellikle konferans sona erdikten kısa süre sonra alınmaya hazır olurlar.
Takvim etkinliği
Google Takvim'de, genellikle bir toplantı düzenleyicisi tarafından oluşturulan ve toplantının katılma bilgilerini içeren, birden fazla katılımcının yer aldığı 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.
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.
Yardımcı düzenleyen
Asıl düzenleyeni kaldırma özelliği hariç olmak üzere, düzenleyen tarafından görüşmede düzenleyen yönetimi ayrıcalıkları verilen kişi.
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 hazır 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, toplantı alanı için yazılabilir ve benzersiz 10 karakterlik dize. 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 bilgiler başlıklı makaleyi inceleyin.

Toplantı adı

Toplantı alanı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. 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 düzenleyicisi olmayabilir. Yalnızca bir toplantı düzenleyici olabilir.

Toplantı alanı

Konferansın yapıldığı sanal yer veya kalıcı nesne (ör. toplantı odası). Herhangi bir zamanda bir alanda 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ı görüşmeye başlatan veya görüşmeye katılmasını sağlayan tıklanabilir URL. Her görüşmenin, https://meet.google.com/ ile başlayan ve toplantı kodu ile devam eden benzersiz bir URL'si vardır. Örneğin, https://meet.google.com/abc-mnop-xyz.

Katılımcı

Bir görüşmeye katılan veya Tamamlayıcı Mod'u kullanan, izleyici olarak izleyen ya da bir görüşmeye bağlı olan 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 çok kez katılırsa her biri için benzersiz oturum kimlikleri atanır.