İçeriğe geç
Bu sayfada

Entegrasyonlar

Google Meet kayıtlarını otomatik ekleme ve öğrenciye bildirme

Google Meet kaydını Apps Script ya da n8n ile 1:1 görüşmeye veya canlı etkinliğe otomatik ekleyin: erişim kodu oluşturun, uç noktaya meetLink ve recordedAt gönderin.

Google Meet'te yaptığınız 1:1 görüşmelerin ve canlı etkinliklerin kayıtlarını öğrencilerinize ilgili sayfada gösterebilirsiniz. Bu sayfa kaydı otomatik eklemeyi anlatır. Kurduğunuz tek bir otomasyon (Apps Script ya da n8n gibi), bir Meet kaydı hazır olduğunda onu doğru görüşmeye ya da etkinliğe ekler ve öğrenciye kaydın hazır olduğunu bildirir. Otomasyonu içerik başına ayrı ayrı kurmanız gerekmez; bütün görüşmeler ve etkinlikler için tek bir otomasyon yeterlidir.

Nasıl çalışır

Otomasyonunuz kendi Google hesabınızdan tamamlanan kaydı ve onun Meet bağlantısını okur, kaydı oynatılabilir bir adrese taşır ve Teachfluence'a gönderir. Teachfluence bu bağlantıdaki Meet koduyla doğru 1:1 görüşmeyi ya da canlı etkinliği bulur, kaydı ekler ve öğrenciye haber verir. Teachfluence arayüzünden içerik başına kimlik kopyalamanız gerekmez.

1. Meet bağlantısının Teachfluence'ta kayıtlı olduğundan emin olun

Teachfluence, gelen kaydı Meet bağlantısındaki koddan tanır. Bu yüzden görüşmenin ya da etkinliğin Meet bağlantısı Teachfluence'ta kayıtlı olmalıdır.

1:1 görüşmeler: Randevuları Teachfluence üzerinden planlanan ve Toplantı Platformu olarak Google Meet seçilen görüşmelerde, Teachfluence her randevu için bağlı Google Takvim'de bir etkinlik ve Meet bağlantısı oluşturur. Bunun için Google Takvim entegrasyonu bağlı olmalıdır. Toplantı platformunu görüşmeyi oluştururken ya da görüşmenin ayarlarında seçersiniz; ayrıntı için Birebir görüşme oluşturma dokümanına bakın.

Canlı etkinlikler: Etkinliğin Meet bağlantısını siz girersiniz. Ürünler › Canlı Etkinlikler altından etkinliği açın. Ayarlar sekmesinin Genel görünümünde, Etkinlik Ayarları kartındaki Ayarları düzenle'ye tıklayın. Toplantı URL'si alanına Google Meet bağlantısını yapıştırın ve Değişiklikleri kaydet'e tıklayın.

Pencerede Zoom görüşmesini otomatik oluştur anahtarı açıksa Toplantı URL'si alanı görünmez; bu etkinliğin toplantısı Zoom ile oluşturulur ve bu akışa girmez.

Etkinliğin başlangıç ve bitiş saatleri de toplantının gerçek saatleriyle uyuşmalıdır. Teachfluence kaydı bu saatlere göre eşler; ayrıntı aşağıdaki Sorun giderme bölümündedir.

2. Erişim kodu oluşturun

Erişim kodu Ayarlar › Entegrasyonlar ve Bildirimler › Geliştirici bölümünde oluşturulur. Sol menüden Ayarlar'a gidin. Sayfanın üstündeki Entegrasyonlar ve Bildirimler menüsünü açın ve Entegrasyonlar başlığı altındaki Geliştirici'yi seçin.

Otomasyon erişim kodları (API token) kartında Erişim kodu oluştur'a tıklayın.

Açılan pencerede erişim koduna tanıyabileceğiniz bir Ad verin (en fazla 100 karakter), örneğin "n8n kayıt senkronizasyonu". İsterseniz Son kullanma (isteğe bağlı) tarihi seçin; sürekli çalışan bir otomasyon için boş bırakın. Kapsam otomatik olarak Kayıt aktarımı olur; erişim kodları şimdilik yalnızca kayıt aktarım uç noktasına erişim sağlar.

Penceredeki Erişim kodu oluştur'a tıklayın. Erişim kodunuzu şimdi kopyalayın penceresinde kodun yanındaki kopyalama düğmesiyle kodu kopyalayın, otomasyon aracınızın gizli kimlik bilgisi alanına kaydedin ve Tamam'a tıklayın.

3. Uç noktayı kopyalayın

Aynı sayfada, erişim kodu kartının altındaki Uç noktalar bölümünde iki satır vardır:

Uç noktaNe yapar
Genel kayıt aktarımıÖnerilen yol. Kaydı hem 1:1 görüşmelere (panelde "koçluk görüşmeleri") hem canlı etkinliklere, Google Takvim etkinliğinden ya da Meet bağlantısından kendisi eşleyerek ekler.
Tek etkinlik için kayıt aktarımıKaydı, kimliğini kendiniz verdiğiniz tek bir canlı etkinliğe ekler. Google Meet için Genel kayıt aktarımı bunun yerini alır.

Genel kayıt aktarımı satırındaki adresi kopyalayın. Örnek isteği göster'e tıklayınca hazır bir curl komutu ve bir n8n HTTP Request düğümü örneği açılır.

Genel kayıt aktarımı adresi:

https://api.teachfluence.com/api/recording-ingest

Paneldeki hazır örnek, eşleştirme alanı olarak yalnızca googleEventId taşır ve bu alan yalnızca 1:1 görüşmelerde çalışır. Hem 1:1 görüşme hem canlı etkinlik için 5. adımdaki meetLink ve recordedAt alanlarını da gönderin.

4. Kaydı oynatılabilir bir bağlantıya çevirin

Otomasyonunuz kaydı göndermeden önce onu oynatılabilir bir bağlantıya çevirmelidir. İki hedefin kuralları farklıdır. 1:1 görüşmeler yalnızca tanınan video sağlayıcılarının bağlantılarını kabul eder. Canlı etkinlikler herhangi bir https adresini kabul eder, ancak kabul edilen her adres öğrenciye oynatılmaz.

Bağlantı türü1:1 görüşmeCanlı etkinlik
Listelenmemiş ya da herkese açık YouTube bağlantısıKabul edilir ve oynatılır (önerilen)Kabul edilir ve oynatılır (önerilen)
Vimeo bağlantısıKabul edilir ve oynatılırKabul edilir ve oynatılır
Loom ya da Wistia bağlantısıKabul edilir, oynatılacağı doğrulanmazKabul edilir, oynatılacağı doğrulanmaz
Kendi sunucunuzdaki doğrudan video dosyası (.mp4)Reddedilir (422)Kabul edilir ve oynatılır
Google Drive görüntüleme ya da paylaşım bağlantısıKabul edilir ama oynatılmazKabul edilir ama oynatılmaz
Zoom kayıt sayfası bağlantısı (/rec/share/, /rec/play/)Reddedilir (422)Reddedilir (422)
Dropbox ya da OneDrive önizleme bağlantısıReddedilir (422)Kabul edilir ama oynatılmaz

Her iki hedefte de çalışan ve oynatılan seçenekler YouTube ve Vimeo'dur. Otomasyonunuzu listelenmemiş YouTube ya da Vimeo üzerine kurun.

5. Otomasyonu kurun

Otomasyonunuzda üç adım vardır: kaydın hazır olduğunu algılayan bir tetikleyici, kaydı oynatılabilir bağlantıya çeviren bir adım ve uç noktaya POST isteği gönderen bir adım.

Görüşmeyi ya da etkinliği eşleştirmek için kaydın Meet bağlantısını (meetLink) ve başlangıç zamanını (recordedAt) gönderin. Bu ikisi hem 1:1 görüşmelerde hem canlı etkinliklerde çalışır. <YOUR_TOKEN> yerine erişim kodunuzu yazın:

curl -X POST 'https://api.teachfluence.com/api/recording-ingest' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"externalUrl":"https://youtu.be/AbCdEfGhIjK","meetLink":"https://meet.google.com/abc-defg-hij","recordedAt":"2026-07-24T10:02:00Z"}'

İstek gövdesindeki alanlar:

AlanNe işe yararKapsam
meetLink + recordedAtMeet bağlantısındaki kodla eşler. Aynı bağlantı birden fazla oturumda kullanıldıysa recordedAt doğru oturumu seçer. meetLink gönderdiğinizde recordedAt zorunludur. meetLink, https://meet.google.com/abc-defg-hij biçiminde bir Meet adresi olmalıdır.1:1 görüşme ve canlı etkinlik
googleEventIdGoogle Takvim etkinlik kimliğiyle kesin eşleşme sağlar.Yalnızca 1:1 görüşme
externalUrlKaydın oynatılabilir bağlantısı (https).İkisi
videoIdVideo kütüphanenizdeki bir videonun kimliği. externalUrl ile videoId'den yalnızca birini gönderin.İkisi

googleEventId ile meetLink alanlarından en az birini gönderin. recordedAt kaydın başladığı an olmalı ve saat dilimi içermelidir: 2026-07-24T10:02:00Z ya da 2026-07-24T13:02:00+03:00 gibi. Saat dilimi olmayan bir değer 422 ile reddedilir.

6. Sonucu kontrol edin

Bir istek geldiğinde Teachfluence gönderilen bilgiyi yalnızca kendi kuruluşunuz içinde arar, doğru 1:1 görüşmeyi ya da canlı etkinliği bulur ve kaydı ekler. Eklenen kaydı içeriğin Kayıt kartında görürsünüz:

  • Canlı etkinlik: Ürünler › Canlı Etkinlikler altından etkinliği açın ve İçerik sekmesine geçin.
  • 1:1 görüşme: Ürünler › 1:1 Görüşmeler altından görüşmeyi açın, Seanslar sekmesinde randevuyu açın. Kayıt kartı yalnızca durumu Tamamlandı olan randevularda görünür.

Öğrenciye yalnızca ilk kayıt eklendiğinde haber verilir; bir kaydı değiştirmek tekrar bildirim göndermez. Canlı etkinliklerde e-posta yalnızca yayında olan etkinliğin kayıtlı öğrencilerine gider.

Yanıt kodları

Uç nokta, "isteğiniz hatalı, tekrar denemeyin" ile "geçici bir aksaklık, tekrar deneyin" durumlarını ayırır. Otomasyonunuzu buna göre kurun:

KodAnlamıOtomasyon ne yapmalı
200Kayıt eklendiTamam
200 (skipped)İçerik bulundu ama kayıt eklenmedi (zaten bir kayıt var, otomatik ekleme kapalı ya da randevu iptal)Tamam, tekrar denemeyin
403Erişim kodu geçersiz, süresi dolmuş ya da iptal edilmiş; ya da kodu oluşturan üye erişimi kaybetmişKodu düzeltin ya da yeniden oluşturun
404Bu bağlantıya ya da kimliğe uyan görüşme veya etkinlik bulunamadıMeet bağlantısını ve zamanı kontrol edin
409Belirsiz eşleşme: aynı Meet bağlantısını aynı saatlerde kullanan birden fazla oturum var, recordedAt başka bir randevuya daha iyi uyuyor ya da video başka bir görüşmenin kaydıİsteği düzeltin ya da kaydı elle ekleyin
422Geçersiz istek: googleEventId ve meetLink ikisi de yok, meetLink geçersiz bir Meet adresi, meetLink var ama recordedAt yok, saat dilimi eksik, videoId ile externalUrl'den ikisi birden ya da hiçbiri gönderildi, kabul edilmeyen bir bağlantı (4. adım), gövde JSON nesnesi değilİsteği düzeltin
429Çok fazla istek: bir erişim koduyla dakikada 60'tan, bir IP adresinden dakikada 120'den fazla istekBekleyip tekrar deneyin
500Geçici sunucu hatasıGüvenle tekrar denenebilir

Başarılı yanıt, gönderdiğiniz eşleştirme alanlarını geri yansıtır:

{ "ok": true, "meetLink": "https://meet.google.com/abc-defg-hij" }

Kaydı işlerken oluşan hatalarda yanıt { "ok": false, "userErrors": [...] } biçimindedir; userErrors içindeki message hatanın nedenini İngilizce açıklar.

Otomasyon aracını seçin

Bu akışı istediğiniz araçla kurabilirsiniz. Hangisini seçerseniz seçin, kaydı göndermeden önce oynatılabilir bir bağlantıya çevirin (4. adım).

Google Apps Script

Betik doğrudan Google hesabınızda çalışır. Drive, Takvim ve YouTube'a buradan eriştiği için ayrı bir sunucu gerekmez.

Aşağıdaki betik iki gelişmiş Google hizmeti kullanır: Google Calendar API ve YouTube Data API v3. Projenizde bu iki hizmeti açın, betiği yapıştırın, TOKEN ve FOLDER_ID değerlerini doldurun ve syncRecordings işlevini zamana bağlı bir tetikleyiciyle (örneğin saatte bir) çalıştırın. İlk çalıştırmada Google'ın istediği Drive, Takvim ve YouTube izinlerini onaylayın.

const TOKEN = 'lerec_...'; // Ayarlar > Entegrasyonlar ve Bildirimler > Geliştirici
const ENDPOINT = 'https://api.teachfluence.com/api/recording-ingest';
const FOLDER_ID = 'DRIVE_KLASOR_ID'; // Meet kayıtlarının düştüğü Drive klasörü

// Klasördeki yeni kayıtları tarar; her birini bir kez işler.
function syncRecordings() {
  const seen = PropertiesService.getScriptProperties();
  const files = DriveApp.getFolderById(FOLDER_ID).getFilesByType('video/mp4');
  while (files.hasNext()) {
    const file = files.next();
    if (seen.getProperty(file.getId())) continue; // daha önce gönderildi
    const ev = findMeetEventForFile(file); // { googleEventId, meetLink, recordedAt }
    if (!ev || !ev.meetLink) continue;     // eşleşen Meet etkinliği yok; sonraki tarama denesin
    const playableUrl = uploadToYouTubeUnlisted(file);
    const res = UrlFetchApp.fetch(ENDPOINT, {
      method: 'post',
      contentType: 'application/json',
      headers: { Authorization: 'Bearer ' + TOKEN },
      muteHttpExceptions: true,
      payload: JSON.stringify({
        googleEventId: ev.googleEventId, // 1:1 görüşmede kesin eşleşme
        meetLink: ev.meetLink,           // canlı etkinlik + 1:1 görüşme için
        recordedAt: ev.recordedAt,       // meetLink ile zorunlu
        externalUrl: playableUrl,
      }),
    });
    if (res.getResponseCode() < 300) {
      seen.setProperty(file.getId(), '1'); // yalnızca başarıda işaretle
    } else {
      console.log('Gönderim başarısız: ' + res.getResponseCode() + ' ' + res.getContentText());
    }
  }
}

// Drive'daki videoyu YouTube'a "unlisted" olarak yükler, izlenebilir bağlantıyı döndürür.
function uploadToYouTubeUnlisted(file) {
  const video = YouTube.Videos.insert(
    {
      snippet: { title: file.getName(), description: 'Teachfluence görüşme kaydı' },
      status: { privacyStatus: 'unlisted' },
    },
    'snippet,status',
    file.getBlob()
  );
  return 'https://youtu.be/' + video.id;
}

// Kaydın ait olduğu Meet etkinliğini bulur: dosyanın oluşturulma zamanından
// önceki 6 saat içinde biten en son Meet etkinliği.
function findMeetEventForFile(file) {
  const created = file.getDateCreated();
  const windowStart = new Date(created.getTime() - 6 * 60 * 60 * 1000);
  const res = Calendar.Events.list('primary', {
    timeMin: windowStart.toISOString(),
    timeMax: created.toISOString(),
    singleEvents: true,
    orderBy: 'startTime',
  });
  let best = null;
  (res.items || []).forEach(function (e) {
    const isMeet = e.hangoutLink || (e.conferenceData && e.conferenceData.conferenceId);
    if (!isMeet || !e.end || !e.end.dateTime) return;
    if (new Date(e.end.dateTime) > created) return; // henüz bitmemiş
    if (!best || new Date(e.end.dateTime) > new Date(best.end.dateTime)) best = e;
  });
  if (!best) return null;
  return {
    googleEventId: best.id,
    meetLink: best.hangoutLink,       // https://meet.google.com/abc-defg-hij
    recordedAt: best.start.dateTime,  // saat dilimli ISO-8601
  };
}

n8n, Make ya da Zapier

Akış aynıdır: tetikleyici (Drive'da yeni kayıt), yeniden barındırma (YouTube'a listelenmemiş yükleme) ve uç noktaya HTTP POST. n8n için panelde hazır bir n8n HTTP Request düğümü örneği vardır. Gövdeyi meetLink ve recordedAt ile tamamladığınızda düğüm alanları şöyle olur:

Method: POST
URL: https://api.teachfluence.com/api/recording-ingest
Authentication: Generic Credential Type → Header Auth
  Header Name: Authorization
  Header Value: Bearer <YOUR_TOKEN>
Send Body: On (JSON)
Body:
{
  "externalUrl": "https://youtu.be/AbCdEfGhIjK",
  "meetLink": "https://meet.google.com/abc-defg-hij",
  "recordedAt": "2026-07-24T10:02:00Z"
}

Kaydı elle ekleme

Tek bir kayıt için otomasyon kurmanız gerekmez. 6. adımda anlatılan Kayıt kartında Kayıt ekle'ye tıklayın. Açılan pencerede Bağlantı yapıştır, Kütüphaneden seç ya da Video yükle seçeneğiyle ilerleyin. Bir bağlantı yapıştırdığınızda pencere, bağlantının öğrenciler için oynatılıp oynatılmayacağını hemen söyler. Google Drive, Zoom paylaşım bağlantısı, Dropbox ya da OneDrive önizlemesi gibi oynatılmayan bir bağlantıda sizi uyarır.

Ayrıntılar için Birebir görüşme yönetim paneli ve Canlı etkinlik ayarları dokümanlarına bakın.

Güvenlik ve bakım

  • Erişim kodunu parola gibi saklayın. Kod lerec_ ile başlar ve kuruluşunuza kayıt ekleme yetkisi verir. Otomasyonun gizli kimlik bilgisi alanında tutun, düz metin akışlarına yazmayın.
  • Ekip değişiminde yenileyin. Erişim kodu onu oluşturan üye gibi davrandığından, o kişinin rolü değişince ya da ekipten ayrılınca kodu iptal edip yeniden oluşturun.
  • Kullanımı izleyin. Tablodaki Son kullanım sütunu, otomasyonun kodu en son ne zaman kullandığını gösterir.
  • İptal edin. Tablodaki İptal et ile bir kodu hemen geçersiz kılarsınız; o kodu kullanan otomasyonlar çalışmayı durdurur ve bu işlem geri alınamaz. İptal edilen ve süresi dolan kodlar 403 döner.

Sorun giderme

BelirtiOlası nedenÇözüm
Öğrenciler boş bir oynatıcı görüyorGoogle Drive görüntüleme bağlantısı gönderildiListelenmemiş bir YouTube ya da Vimeo bağlantısı gönderin
404 (bulunamadı)Meet bağlantısı yanlış; canlı etkinliğin Toplantı URL'si alanında Meet bağlantısı yok; 1:1 görüşme Google Meet ile planlanmamış ya da randevu iptal edilmiş; recordedAt oturumun saatine uymuyorBağlantıyı ve zamanı kontrol edin. Kaydın başlangıcı, oturumun planlanan başlangıcından 1 saatten daha önce ya da planlanan bitişinden 6 saatten daha sonra ise eşleşmeyebilir
409Aynı Meet bağlantısı aynı saatlerde birden fazla oturumda kullanılıyorKaydı içeriğin Kayıt kartından elle ekleyin
Her istek 403 dönüyorKod iptal edilmiş, süresi dolmuş ya da oluşturan üye erişimi kaybetmişAktif bir yönetici altında yeni kod oluşturun
Yanıt skipped dönüyor ama kayıt görünmüyorİçerikte zaten bir kayıt var, kaydın otomatik eklenmesi kapalı ya da randevu iptal edilmişKaydı içeriğin Kayıt kartından elle ekleyin ya da değiştirin
1:1 görüşmede 422Kabul edilmeyen bir bağlantı gönderildi (kendi sunucunuzdaki .mp4, Dropbox, OneDrive, Zoom kayıt sayfası)Kaydı YouTube ya da Vimeo'ya taşıyın
Zoom görüşmesinin kaydı gelmiyorBu akış Google Meet içindirZoom kayıtları Zoom entegrasyonuyla gelir
E-posta gitmediİçeriğe daha önce kayıt eklenmişti ya da canlı etkinlik yayında değilYalnızca ilk kayıt bildirim gönderir

İlgili