Bu rehberde: Google hesabınızın birincil takvimini OrqLabs'a bağlarsınız. Google Calendar kutusuyla etkinlik oluşturur (isteğe bağlı Google Meet bağlantısı ve katılımcılara e-posta daveti) ve yaklaşan etkinlikleri okursunuz; Entegrasyon olayı tetikleyicisi takviminize yeni bir etkinlik eklendiğinde iş akışını başlatır.
⏱ 5 dakika (platformun Google uygulaması hazırsa)
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | GOOGLE_CALENDAR |
| Kategori | Randevu / takvim |
| Kimlik doğrulama | Google izin ekranı (OAuth 2.0) – platformun Google istemcisi, yalnızca takvim izni |
| Kapsam | Proje bazlı |
| Webhook | Hayır (yeni etkinlikler 5 dakikada bir kontrol edilir) |
| Kutu | Google Calendar (app.googleCalendar) |
| Tetikleyici | Entegrasyon olayı → GOOGLE_CALENDAR · New event |
Ne işe yarar?
Create event (Etkinlik oluştur) – başkalarına davet gidebildiği için test çalıştırmalarında etkinlik oluşturulmaz.
| Alan | Açıklama |
|---|---|
| Title | Etkinlik başlığı, ör. Demo görüşmesi – {{ $json.company }} |
| Start | 2026-10-12T14:00 (takvimin saat diliminde), 2026-10-12T14:00:00+03:00 (ofsetli) veya 2026-10-12 (tüm gün) |
| End / Duration | Bitiş boşsa başlangıç + süre (varsayılan 30 dk) |
| Time zone | Ofsetsiz saatler için IANA saat dilimi, ör. Europe/Istanbul (boş: takvimin saat dilimi) |
| Attendees | Virgülle ayrılmış e-posta adresleri, ör. {{ $json.email }} |
| Add Google Meet link | Açıkken etkinliğe Meet bağlantısı eklenir (varsayılan açık) |
| Send invitations | Tüm katılımcılara / yalnızca alan adınız dışındakilere / gönderme |
Çıktı: id, summary, start, end, allDay, meetLink, htmlLink, attendeeEmails … Sonraki adımda {{ $json.meetLink }} ile Meet bağlantısını adaya e-postayla veya WhatsApp'tan gönderebilirsiniz.
List events (Etkinlikleri listele) – bir zaman aralığındaki etkinlikler (varsayılan: şimdi → 7 gün sonrası), tekrarlayan etkinlikler tek tek açılmış ve başlangıca göre sıralı; her etkinlik ayrı bir öğe. Arama metniyle başlık, açıklama, konum ve katılımcılarda filtreleyebilirsiniz.
Tetikleyici – New event: birincil takviminize yeni bir etkinlik eklendiğinde (siz oluşturduğunuzda, bir randevu aracı eklediğinde veya bir davet geldiğinde) iş akışı başlar. Düzenlenen veya silinen eski etkinlikler tetiklemez. Tetikleyici ilk çalıştığında yalnızca başlangıç noktasını kaydeder; geçmiş etkinlikler için çalıştırma başlamaz.
Ön koşullar
- Bir Google hesabı (Gmail veya Google Workspace); kullanılan takvim hesabın birincil takvimidir.
- Workspace'te yöneticiniz üçüncü taraf uygulamaları kısıtladıysa OrqLabs'a güvenmesi gerekir (Yönetici konsolu → Güvenlik → API denetimleri).
Adım adım kurulum
A) Google Cloud Console (platform yöneticisi)
- APIs & Services → Library → Google Calendar API → Enable.
- Google Auth Platform → Data Access → kapsam ekleyin:
https://www.googleapis.com/auth/calendar.events(hassas kapsam),openid,.../auth/userinfo.email. - Clients → Web application istemcisi → Authorized redirect URIs →
https://api.orqlabs.com/api/v1/integrations/oauth/google_calendar/callback→ Save. calendar.eventshassas kapsam olduğu için herkese açık kullanımdan önce Verification Center'dan OAuth doğrulaması (kullanım gerekçesi + demo videosu) gerekir; o zamana kadar hesapları Audience → Test users listesine ekleyin (Testing modunda yetki 7 günde bir yenilenmelidir). CASA değerlendirmesi gerekmez.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Google Calendar → Bağla → Proje.
- Takvimin sahibi olan Google hesabını seçin → takvim iznini onaylayın.
- Kartta Google hesabınız görünür. Bağlantıyı test et: takvim adı ve saat dilimi.
- İş akışında Google Calendar kutusunu ekleyin veya Entegrasyon olayı tetikleyicisinde
GOOGLE_CALENDAR · New eventseçin.
Örnek akış
Form başvurusu → demo toplantısı: Entegrasyon olayı (GOOGLE_FORMS · New form response) → Google Calendar – Create event (Title: Demo – {{ $json.name }}, Start: formdaki tarih, Attendees: {{ $json.email }}) → E-posta gönder (Meet bağlantısı: {{ $json.meetLink }}).
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
https://www.googleapis.com/auth/calendar.events | Etkinlik oluşturma, listeleme ve yeni etkinlikleri okuma |
openid, .../auth/userinfo.email | Bağlanan Google hesabının adresi (kartta görünür) |
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
INVALID – "is not an ISO 8601 date" | Başlangıç/bitiş biçimi tanınmadı | 2026-10-12T14:00 veya 2026-10-12 biçimini kullanın |
INVALID – "not an e-mail address" | Katılımcı listesinde geçersiz adres | Adresleri virgülle ayırın; boş değerleri temizleyin |
CONFIG – "Google Calendar API … etkin değil" | API Cloud projesinde kapalı | Platform yöneticisi Google Calendar API'yi etkinleştirmeli |
FORBIDDEN – "Google izni eksik" | İzin ekranında takvim kutusu işaretlenmedi | Yeniden yetkilendir, tüm kutuları işaretleyin |
AUTH – invalid_grant | İzin iptal edildi veya süresi doldu | Yeniden yetkilendir |
| Meet bağlantısı yok | Hesapta Google Meet kapalı (Workspace yöneticisi) | Yöneticiden Meet'i açmasını isteyin veya "Add Google Meet link"i kapatın |