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.
Başlamadan önce
- Erişim kodunu yalnızca Sahip ya da Yönetici rolündeki ekip üyeleri oluşturur ve görür.
- Otomasyon aracınız, tamamlanan kaydı ve onun Takvim/Meet bilgisini okuyabileceği Google hesabına bağlı olmalı.
- Kaydın tarayıcıda oynatılabilir bir bağlantısı olmalı (4. adım).
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.
En kritik nokta: oynatılabilir bağlantı
Teachfluence gönderdiğiniz bağlantıyı öğrencinin tarayıcısında oynatır; videoyu indirmez ya da yeniden barındırmaz. Google Meet kayıtları genelde Google Drive'a düşer. Drive görüntüleme bağlantıları bir görüntüleyici sayfası açar ve oynatılmaz. En güvenli yol: otomasyonunuz kaydı önce listelenmemiş bir YouTube videosuna ya da Vimeo'ya yüklesin.
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.
Zoom kullanıyorsanız
Bu akış yalnızca Google Meet bağlantılarını tanır. Zoom ile yönetilen etkinliklerin ve görüşmelerin kayıtları Zoom entegrasyonuyla gelir.
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.
Erişim kodunu bir daha göremezsiniz
Pencereyi kapattıktan sonra kod tekrar gösterilmez. Kaybederseniz eskisini iptal edip yenisini oluşturun. Erişim kodu, onu oluşturan üye gibi davranır: o üye gerekli erişimi kaybederse ya da ekipten ayrılırsa istekler 403 döner. Bu durumda erişim kodunu aktif bir yönetici altında yeniden oluşturun.
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ç nokta | Ne 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üşme | Canlı 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ır | Kabul edilir ve oynatılır |
| Loom ya da Wistia bağlantısı | Kabul edilir, oynatılacağı doğrulanmaz | Kabul 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ılmaz | Kabul 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"}'
Karttaki örnek adresi olduğu gibi kullanmayın
Paneldeki hazır örnek externalUrl için https://your-storage.example.com/recording.mp4 gibi bir yer tutucu gösterir. Kendi sunucunuzdaki bir dosya adresi yalnızca canlı etkinliklerde kabul edilir; 1:1 görüşmelerde reddedilir. Yerine listelenmemiş bir YouTube ya da Vimeo bağlantısı yazın.
İstek gövdesindeki alanlar:
| Alan | Ne işe yarar | Kapsam |
|---|---|---|
meetLink + recordedAt | Meet 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 |
googleEventId | Google Takvim etkinlik kimliğiyle kesin eşleşme sağlar. | Yalnızca 1:1 görüşme |
externalUrl | Kaydın oynatılabilir bağlantısı (https). | İkisi |
videoId | Video 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.
En geniş kapsam
Üç eşleştirme alanını (meetLink, recordedAt ve googleEventId) birlikte gönderebilirsiniz. 1:1 görüşmede googleEventId kesin eşleşme sağlar. Bu kimlikle bir görüşme bulunamaz ya da eşleşme belirsiz kalırsa Teachfluence meetLink ile önce 1:1 görüşmelerde, sonra canlı etkinliklerde arar.
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.
Eşleşti ama eklenmedi (skipped)
Bir istek doğru içeriğe ulaşıp da kaydı eklemeyebilir. Yanıt bu durumda { "ok": true, "skipped": "..." } olur ve skipped nedeni söyler:
already_linked: içerikte zaten bir kayıt var. Var olan kayıt asla üzerine yazılmaz.auto_publish_disabled: bu içerik için kaydın otomatik eklenmesi kapalı.canceled:googleEventIdile bulunan randevu iptal edilmiş.
Bu normaldir; isteği tekrar göndermeyin.
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:
| Kod | Anlamı | Otomasyon ne yapmalı |
|---|---|---|
| 200 | Kayıt eklendi | Tamam |
200 (skipped) | İçerik bulundu ama kayıt eklenmedi (zaten bir kayıt var, otomatik ekleme kapalı ya da randevu iptal) | Tamam, tekrar denemeyin |
| 403 | Eriş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 |
| 404 | Bu bağlantıya ya da kimliğe uyan görüşme veya etkinlik bulunamadı | Meet bağlantısını ve zamanı kontrol edin |
| 409 | Belirsiz 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 |
| 422 | Geç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 istek | Bekleyip tekrar deneyin |
| 500 | Geç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
};
}
Bilmeniz gerekenler
- Betiği, Meet kayıtlarının Drive'da tutulduğu Google hesabında çalıştırın. Betik etkinlikleri bu hesabın birincil takviminde (
'primary') arar. Teachfluence 1:1 randevularını bağlı Google Takvim'e (ortak takvim ya da atanan eğitmenin takvimi) ekler; randevularınız birincil takvimde değilse'primary'yerine o takvimin kimliğini yazın. - Etkinlik eşleştirmesi zamana dayalı bir tahmindir: kayıttan hemen önce biten Meet etkinliğini seçer. Üst üste binen toplantılarınız varsa
findMeetEventForFileişlevini kendi durumunuza göre daraltın. - YouTube'a yükleme başarısız olursa kaydı Vimeo'ya yükleyin. 1:1 görüşmelerde kendi sunucunuzdaki bir
.mp4bağlantısı kabul edilmez.
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
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Öğrenciler boş bir oynatıcı görüyor | Google Drive görüntüleme bağlantısı gönderildi | Listelenmemiş 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 uymuyor | Bağ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 |
| 409 | Aynı Meet bağlantısı aynı saatlerde birden fazla oturumda kullanılıyor | Kaydı içeriğin Kayıt kartından elle ekleyin |
| Her istek 403 dönüyor | Kod 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 422 | Kabul 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ı gelmiyor | Bu akış Google Meet içindir | Zoom kayıtları Zoom entegrasyonuyla gelir |
| E-posta gitmedi | İçeriğe daha önce kayıt eklenmişti ya da canlı etkinlik yayında değil | Yalnızca ilk kayıt bildirim gönderir |
