Bu rehberde: Google hesabınızı bağlar ve izlenecek formların düzenleme bağlantısını yapıştırırsınız. Biri formu gönderdiğinde (5 dakika içinde) Entegrasyon olayı tetikleyicisi iş akışınızı yanıtla birlikte başlatır; yanıtlar soru başlıklarıyla gelir, e-posta / ad / telefon ayrıca çıkarılır.
⏱ 5 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | GOOGLE_FORMS |
| Kategori | Formlar |
| Kimlik doğrulama | Google izin ekranı (OAuth 2.0) + bağlandıktan sonra form bağlantısı |
| Kapsam | Proje bazlı (bir bağlantı en fazla 10 form izler) |
| Webhook | Hayır (yanıtlar 5 dakikada bir okunur) |
| Tetikleyici | Entegrasyon olayı → GOOGLE_FORMS · New form response |
Ne işe yarar?
Tetikleyici – New form response: izlenen formlardan biri gönderildiğinde iş akışı başlar. İlk öğe şu alanları taşır:
| Alan | Açıklama |
|---|---|
responseId, formId, formTitle | Yanıt ve form; birden çok form izliyorsanız Eğer kutusuyla formId / formTitle'a göre ayırın |
submittedAt | Gönderim zamanı |
email, name, phone | Toplanan e-posta adresi (form "e-posta adreslerini topla" ayarındaysa) veya başlığı e-posta / ad / telefon olan sorulardan |
answers | Soru başlığı → yanıt ({{ $json.answers["Hangi hizmetle ilgileniyorsunuz?"] }}); çoklu seçimler liste, dosya yüklemeleri Drive bağlantısı |
answerList | Sırasıyla questionId, title, value |
totalScore | Sınav (quiz) formlarında puan |
Yalnızca yeni yanıtlar tetikler: tetikleyici ilk çalıştığında başlangıç noktasını kaydeder, sonradan eklediğiniz bir form da o andan itibaren izlenir. Düzenlenen eski yanıtlar yeniden tetiklemez.
Önemli: form bağlantısını siz verirsiniz
Google Forms API bir hesabın formlarını listeleyemez; bu yüzden izlenecek formu siz seçersiniz:
- Formu Google Formlar'da sahibi veya düzenleyicisi olduğunuz hesapla açın.
- Adres çubuğundaki düzenleme bağlantısını kopyalayın:
https://docs.google.com/forms/d/<kimlik>/edit. - Paylaşım (yanıtlama) bağlantısı
…/forms/d/e/…/viewformveyaforms.gle/…çalışmaz; OrqLabs bu durumda uyarır.
Adım adım kurulum
A) Google Cloud Console (platform yöneticisi)
- APIs & Services → Library → Google Forms API → Enable.
- Google Auth Platform → Data Access → kapsam ekleyin:
https://www.googleapis.com/auth/forms.responses.readonly,https://www.googleapis.com/auth/forms.body.readonly,openid,.../auth/userinfo.email. - Clients → Web application istemcisi → Authorized redirect URIs →
https://api.orqlabs.com/api/v1/integrations/oauth/google_forms/callback→ Save. - Forms kapsamları hassas kapsamlardır: herkese açık kullanımdan önce Verification Center'dan OAuth doğrulaması (gerekçe + demo videosu) gerekir; o zamana kadar hesapları Audience → Test users listesine ekleyin (Testing modunda yetki 7 günde bir yenilenmelidir).
B) OrqLabs'ta bağlama
- Entegrasyonlar → Google Forms → Bağla → Proje; isterseniz Form edit link(s) alanına düzenleme bağlantısını şimdiden yapıştırın.
- Formun sahibi/düzenleyicisi olan Google hesabını seçin → izinleri onaylayın.
- Ayrıntı panelinde İzlenen formlar: düzenleme bağlantılarını her satıra bir tane olacak şekilde yapıştırın (en fazla 10) → Kaydet. Formların başlıkları listede görünür; okunamayan formun yanında nedeni yazar.
- İş akışında Entegrasyon olayı tetikleyicisini ekleyin → hesap olarak bu Google Forms bağlantısını, olay olarak
GOOGLE_FORMS · New form response'u seçin → iş akışını etkinleştirin.
Örnek akış
Başvuru formu → aday + teşekkür e-postası: Entegrasyon olayı (GOOGLE_FORMS · New form response) → Aday oluştur (E-posta: {{ $json.email }}, Ad: {{ $json.name }}, Kaynak: {{ $json.formTitle }}) → E-posta gönder (Gmail hesabınızdan teşekkür) → isteğe bağlı Google Calendar – Create event.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
https://www.googleapis.com/auth/forms.responses.readonly | Yanıtları okumak |
https://www.googleapis.com/auth/forms.body.readonly | Soru başlıklarını okumak (yanıtlar soru kimliğiyle gelir) |
openid, .../auth/userinfo.email | Bağlanan Google hesabının adresi |
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| "Bu, formun paylaşım (yanıtlama) bağlantısı" | /viewform veya forms.gle bağlantısı yapıştırıldı | Düzenleme bağlantısını (…/edit) kullanın |
CONFIG – "izlenecek form seçilmedi" | Form bağlantısı girilmedi | Ayrıntı panelinde İzlenen formlar'a yapıştırın |
FORBIDDEN / NOT_FOUND – "form … açılamadı" | Hesap formun sahibi/düzenleyicisi değil veya kimlik yanlış | Formu doğru hesapla açıp bağlantıyı yeniden kopyalayın; gerekirse doğru hesapla yeniden bağlanın |
CONFIG – "Google Forms API … etkin değil" | API Cloud projesinde kapalı | Platform yöneticisi Google Forms API'yi etkinleştirmeli |
| İş akışı başlamıyor | İş akışı etkin değil veya tetikleyicide başka hesap seçili | İş akışını etkinleştirin; tetikleyicide bu bağlantıyı seçin. Yanıtlar 5 dakikaya kadar gecikmeli gelir |
email boş | Form e-posta toplamıyor ve e-posta sorusu yok | Forms'ta Ayarlar → Yanıtlar → E-posta adreslerini topla'yı açın veya bir e-posta sorusu ekleyin |