Bu sayfada, Google Formlar API'si için Apps Komut Dosyası web uygulaması örneğine genel bakış sunulmaktadır.
Ön koşullar
- Google Cloud projenizde Forms API'yi etkinleştirin.
- Örnek web uygulaması için GitHub README dosyasında açıklandığı şekilde yeni bir Apps Komut Dosyası projesi oluşturun.
Genel Bakış
Formlar API'si, kimliği doğrulanmış tüm istemcilerin REST kullanarak API'ye doğrudan erişmesine olanak tanır.
Apps Komut Dosyası, hem geçerli bir OAuth erişim jetonu elde etmenin hem de REST çağrıları yapmanın bir yolunu sunduğundan Apps Komut Dosyası'nı doğrudan Forms API ile entegre etmek mümkündür. Apps Komut Dosyası'nda, komut dosyalarının Formlar oluşturmasına, Formlar'a erişmesine ve Formlar'ı değiştirmesine olanak tanıyan mevcut bir Formlar Hizmeti zaten sağlanmaktadır. Ancak, Formlar API'sini doğrudan Apps Komut Dosyası'ndan kullanmayı tercih ederseniz OAuth erişimini aşağıdaki gibi ayarlayın:
Kapsamlı ve kimliği doğrulanmış bir OAuth erişim jetonu alın.
ScriptApp.getOAuthToken();OAuth jetonunu, API'ye yapılan tüm REST çağrılarında sağlanan options bağımsız değişkenine ekleyin.
UrlFetchApp.fetch(Url, options);
Bu işlemin nasıl yapıldığını görmek için Apps Komut Dosyası projesi oluşturma başlıklı makaleyi inceleyin. Kurulum kılavuzunda, API'yi çağırmak için gereken altyapı ayrıntılı olarak açıklanmaktadır. Ancak kullanıcılara API'ye sezgisel erişim sağlamak için örnek web uygulamamızı da deneyebilir ve değiştirebilirsiniz.
Web uygulaması örneği kullanımı
Tüm Forms API yöntemlerini doğrudan çağıran eksiksiz bir örnek web uygulaması apps-script-samples GitHub deposunda mevcuttur.
Web uygulamasını çalıştırma
Projenizi oluşturup web uygulaması olarak dağıttıktan sonra bazı işlemleri deneyebilirsiniz.
Form Oluştur düğmesini tıklayarak yeni bir form oluşturun.
Yeni form artık Form kimliği: alanında görünür ve Formlar'da aç'ı tıklayarak formu açabilirsiniz.
Yeni formu ayrı bir pencerede açtıktan sonra birkaç soruyu manuel olarak eklemeyi deneyin. Ardından Get Form by Id'yi (Formu Kimliğe Göre Al) tıkladığınızda sağdaki JSON çıkışında yeni sorularınızı görürsünüz.
Uygulamada bulunan diğer yöntemleri keşfedin ve her işlem için sağdaki çıktıyı inceleyin.
Forms kol saatleriyle çalışma
Ayrıca formlar saatleri için düğmelere de dikkat edin. Bu işlevler, Forms API'nin izleme özelliğini kullanır ve izleme oluşturma, listeleme, silme ve yenileme işlemlerini gerçekleştirir. Bu konuları kullanmak için Cloud Pub/Sub konuları içeren bir proje oluşturmanız gerekir.
Forms API izlemeleri ve Cloud Pub/Sub hakkında daha fazla bilgi için Push bildirimlerini ayarlama ve alma başlıklı makaleyi inceleyin.
Sonraki adımlar
Örnek uygulamayı ihtiyaçlarınıza göre özelleştirmeyi deneyin. Aşağıda birkaç örnek verilmiştir:
- Google E-Tablolar'da bir soru bankası oluşturun, ardından yeni formları doldurmak için bir sayfadan soru getirmek üzere Apps Komut Dosyası SpreadsheetApp hizmetini kullanın.
- Alternatif olarak, soru bankanız bir SQL veritabanında bulunabilir. Bu durumda, formları veritabanındaki sorularla doldurmak için Apps Komut Dosyası JDBC Hizmeti'ni kullanabilirsiniz.
- Test oluşturun ve puanları Google E-Tablolar not defterine kaydedin.
- Projenizi Cloud Pub/Sub ile ayarlayın ve sınav sonuçlarını göstermek için gerçek zamanlı bir öğrenci skor tablosu oluşturmak üzere izleme özelliğini kullanın.