Google Entegrasyonu

1) Google Entegrasyonunun Faydaları

• Hippotenus'ta oluşturduğunuz canlı dersler otomatik olarak Google Takvim'e eklenir.
• Google Takvim'de yaptığınız değişiklikler (saat değişikliği, iptal vb.) Hippotenus'a otomatik yansır.
• Dersleriniz için ayrı bir "Hippotenus Dersleri" takvimi oluşturarak kişisel takviminizden ayrı tutabilirsiniz.
• Bu takvimi velilerinizle veya öğrencilerinizle paylaşarak ders programlarını şeffaflaştırabilirsiniz.
• Türkiye resmi tatil takvimini ekleyerek tatil günlerinde rezervasyon kabul etmemesini sağlayabilirsiniz.
• Çalışma saatlerinizi belirleyerek mesai dışı saatlerde rezervasyon alınmasını engelleyebilirsiniz.
• Aylık ders raporlarınızı görüntüleyebilir, CSV olarak dışa aktarabilirsiniz.

2) Google Hesabını Bağlama

Adım 1 — Ayarlar sayfasına gidin

• Hippotenus hesabınıza giriş yapın.
• Sol menü/profil menüsü üzerinden Ayarlar bölümüne gidin.
• Sayfa içinde Google Entegrasyonu kartını göreceksiniz.

Adım 2 — "Google Hesabını Bağla" butonuna tıklayın

• Hesap bağlı değilse kartta "Bağlı Değil" etiketi görünür.
• "Google Hesabını Bağla" butonuna tıkladığınızda Google OAuth akışı başlatılır.
• Tarayıcınız popup'ı engelliyorsa adres çubuğundan izin vermeniz gerekir.

Adım 3 — Google ile giriş yapın

• Google giriş ekranında kendi hesabınızı seçin veya bilgilerinizi girin.
• Hesabınızda iki adımlı doğrulama varsa onaylama adımını tamamlayın.

Adım 4 — İzinleri onaylayın

• Google, Hippotenus'un takvimleriniz üzerinde hangi işlemleri yapabileceğini gösterir.
• İstenen izinler: takvim olaylarını okuma/yazma, takvim listesi, e-posta ve profil bilgisi.
• "İzin ver" / "Allow" butonu ile onaylayın.

Adım 5 — Bağlantının başarılı olduğunu doğrulayın

• "Google hesabınız başarıyla bağlandı" bildirim mesajını göreceksiniz.
• Google Entegrasyonu kartında etiket "Bağlı" olarak güncellenir.
• Kart üzerinde bağladığınız hesabın e-posta adresi listelenir.

3) Takvim Tercihleri

Bağlantı tamamlandığında Takvim Tercihleri paneli görünür. Bu panel sayesinde derslerinizin hangi takvimde nasıl görüneceğini özelleştirebilirsiniz.

Varsayılan takvim seçimi

• "Dersler hangi takvime eklensin?" seçimi ile dersleriniz birincil Google takviminize ya da seçtiğiniz başka bir takvime eklenir.
• Her zaman değiştirilebilir; değişiklik sonraki olaylar için geçerlidir.

Hippotenus Dersleri takvimi (önerilen)

• "Takvimi oluştur" butonu ile Google'da Hippotenus Dersleri adında ayrı bir takvim oluşturulur.
• Bu takvim sadece Hippotenus dersleri içerir; kişisel takviminizden ayrı kalır.
• Velilerle veya öğrencilerle paylaşmak için bu takvimin oluşturulmuş olması gerekir.
• Google Takvim'de istediğiniz zaman gizleyebilir veya kaldırabilirsiniz.

Ders türü renkleri

• Matematik, Fizik, Kimya gibi farklı ders türlerine Google Takvim renklerinden seçim yapabilirsiniz.
• Renk seçilmediği sürece takvimin varsayılan rengi kullanılır.
• Toplam 11 hazır renk seçeneği vardır (Lavender, Sage, Grape, Flamingo, Banana, Tangerine, Peacock, Graphite, Blueberry, Basil, Tomato).

4) İki Yönlü Senkronizasyon

Bağlantı sonrası açılan İki Yönlü Senkronizasyon paneli, Google Takvim ile Hippotenus arasındaki veri akışını yönetir. Hippotenus'ta yaptığınız değişiklikler Google'a, Google'da yaptığınız değişiklikler de Hippotenus'a otomatik yansır.

Senkronizasyon durumları

• Senkronize değil — entegrasyon henüz başlatılmamış.
• Senkronize — bağlantı sağlıklı çalışıyor.
• Yakında yenilenecek — webhook süresi yakında dolacak, otomatik yenilenir.
• Senkronizasyon hatası — son senkronizasyon başarısız oldu.
• Süresi doldu — webhook süresi doldu, manuel başlatma gerekebilir.

Manuel kontrol

• "Senkronizasyonu başlat" — pasif durumda iken senkronizasyonu açar.
• "Şimdi senkronize et" — bağlantı sorunlarında manuel tetikleme yapar.
• "Durdur" — senkronizasyonu geçici olarak durdurur (tekrar başlatabilirsiniz).

5) Takvim Paylaşımı

Hippotenus Dersleri takviminizi velilerinizle veya öğrencilerinizle paylaşabilirsiniz. Eklediğiniz kişiler dersleri kendi Google Takvim'lerinde görür.

Önemli: Paylaşım için önce Hippotenus Dersleri takviminin oluşturulmuş olması gerekir. Aksi halde kişisel takviminiz paylaşılır ve bu büyük bir gizlilik riski yaratır. Hippotenus, kişisel takviminizin paylaşımına izin vermez.

Paylaşım yetkileri

• Sadece müsaitlik — kişi sadece meşgul/uygun bilgisini görür, ders detaylarını göremez.
• Görüntüle — ders başlık, saat ve detaylarını görebilir.
• Düzenle — dersleri değiştirebilir; yalnızca güvendiğiniz kişilere verin.

Paylaşım ekleme

• Paylaşım panelinde paylaşmak istediğiniz kişinin e-posta adresini girin.
• Yetki seviyesini seçin.
• "Paylaş" butonuna tıklayın.
• Paylaşılan kişiler listede görünür; istediğiniz zaman X butonuyla paylaşımı kaldırabilirsiniz.

6) Resmi Tatil Takvimi

• Google'ın Türkiye resmi tatil takvimini Hippotenus üzerinden tek tıkla Google hesabınıza ekleyebilirsiniz.
• Bu takvim eklendiğinde rezervasyon ekranlarında resmi tatil günleri otomatik olarak meşgul gösterilir.
• Velileriniz veya öğrencileriniz tatil günlerinde ders rezervasyonu yapamaz.
• İstediğiniz zaman "Tatil takvimini kaldır" butonu ile kaldırabilirsiniz.

7) Çalışma Saatleri

Hangi günlerde ve saatlerde ders verdiğinizi belirleyerek mesai dışı rezervasyonları otomatik olarak engelleyebilirsiniz.

• Hafta içi/sonu için bağımsız ayarlar yapabilirsiniz.
• Her gün için başlangıç ve bitiş saatlerini ayrı ayrı seçebilirsiniz (ör. Pazartesi 09:00 – 18:00).
• Pasif (kapalı) günlerde rezervasyon kabul edilmez.
• Değişikliklerinizi "Kaydet" butonuyla onaylamanız gerekir.
• Rezervasyon ekranları bu aralık dışındaki saatleri öğrencilerden gizler.

8) Ders Raporları ve CSV Dışa Aktarım

Google Takvim'deki Hippotenus dersleriniz üzerinden detaylı raporlar alabilirsiniz.

• Başlangıç ve bitiş tarihlerini seçin (varsayılan olarak içinde bulunulan ay).
• "Raporu yükle" ile dönem özeti gösterilir: ders sayısı, toplam saat, iptal edilen, katılımcı sayısı.
• Aylık dağılım tablosu, hangi ayda kaç ders ve kaç saat ders verdiğinizi gösterir.
• "CSV indir" ile tüm verileri CSV dosyası olarak dışa aktarabilirsiniz; Excel veya Google Sheets'te açabilirsiniz.

9) Bağlantıyı Kaldırma

Yöntem A — Hippotenus üzerinden

• Hippotenus'ta Ayarlar → Google Entegrasyonu kartına gidin.
• Hesap bağlıysa kartta "Bağlantıyı Kes" butonu görünür.
• Butona tıkladığınızda Google OAuth bağlantısı kesilir; tüm token'lar pasifleştirilir.
• Daha önce oluşturulan Google Takvim olayları ve Hippotenus Dersleri takvimi Google hesabınızda kalır; isterseniz kendiniz silebilirsiniz.

Yöntem B — Google Hesap Ayarları üzerinden

• myaccount.google.com/permissions adresine gidin.
• Bağlı uygulamalar listesinde Hippotenus uygulamasını bulun.
• "Erişimi kaldır" seçeneğini tıklayın.
• Onayladığınızda Hippotenus tarafına bir sonraki çağrıda token geçersiz olur ve bağlantı pasif duruma geçer.

Verilerinize ne olur? Bağlantı kesildiğinde Hippotenus, Google OAuth token'larınızı pasifleştirir. Detay için Gizlilik Politikası sayfasını inceleyebilirsiniz.

10) Sıkça Karşılaşılan Sorunlar

"Senkronizasyon hatası" uyarısı

Google webhook süresi dolmuş veya iptal edilmiş olabilir. "Şimdi senkronize et"butonuyla tetikleyin; sorun devam ederse bağlantıyı kesip yeniden bağlayın.

Paylaşım eklenemedi

Hippotenus Dersleri takvimini henüz oluşturmadıysanız paylaşım yapılmaz. Önce "Takvimi oluştur"butonuyla bu takvimi oluşturun.

Tatil takvimi rezervasyonları engellemiyor

Tatil takvimi yalnızca bağlandıktan sonra oluşturulan rezervasyon ekranlarında etkilidir. Sayfayı yenilemeyi ve birkaç dakika beklemeyi deneyin.

Çalışma saatleri kaydedilmiyor

Değişikliklerden sonra "Kaydet" butonuna basmayı unutmayın. Kaydet butonu, bir değişiklik yaptığınızda aktif hale gelir.

11) Destek

Bu sayfada cevabını bulamadığınız sorunlar için İletişim sayfasından destek ekibimize ulaşabilirsiniz.