Bu sayfada, Google Forms API için Apps Script web uygulaması örneğine genel bir 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 doğrudan REST kullanarak API'ye erişmesine olanak tanır.
Apps Komut Dosyası hem geçerli bir OAuth erişim jetonu elde etmeyi hem de REST çağrıları yapmayı kolaylaştırdığından Apps Komut Dosyası'nı doğrudan Forms API ile entegre etmek kolaydır. Apps Komut Dosyası, komut dosyalarının Google Formlar'ı oluşturmasına, erişmesine ve değiştirmesine olanak tanıyan mevcut bir Formlar Hizmeti sağlar. Ancak Forms API'yi doğrudan Apps Script'ten kullanmayı tercih ediyorsanız 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 temel altyapı ayrıntılı olarak açıklanmaktadır. Bununla birlikte, son kullanıcılara API'ye sezgisel erişim sağlamak için örnek web uygulamamızı 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ı, açıklama amacıyla GitHub'da mevcuttur.
Web uygulamasını çalıştırma
Projenizi oluşturup web uygulaması olarak dağıttıktan sonra bazı temel 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. Formlar'da aç'ı tıklayarak bu formu açabilirsiniz.
Yeni formu ayrı bir pencerede açtıktan sonra manuel olarak birkaç soru eklemeyi deneyin. Ardından Formu Kimliğe Göre Al'ı tıklayın. Yeni sorularınızı sağdaki JSON çıkışında görürsünüz.
Uygulamada bulunan diğer yöntemleri keşfedebilir ve her işlem için sağdaki çıktıyı gözlemleyebilirsiniz.
Formlar kol saatleriyle çalışma
Form kol saatlerine ait düğmelere de dikkat edin. Bu API'ler, Forms API izleme özelliğini kullanır ve izleme oluşturma, listeleme, silme ve yenileme gibi temel işlemleri gerçekleştirir. Bu konuları kullanmak için Cloud Pub/Sub konularını içeren bir proje oluşturmanız gerekir.
Formlar API izlemeleri ve Cloud Pub/Sub hakkında daha fazla bilgi için Push bildirimleri oluşturma 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:
- Bir Google e-tablosunda soru bankası oluşturun ve ardından yeni formları doldurmak için bir e-tablodan soru almak üzere Apps Script SpreadsheetApp hizmetini kullanın.
- Alternatif olarak, soru bankanızın bulunduğu bir SQL veritabanında Apps Script JDBC Hizmeti'ni kullanarak formları veritabanındaki sorularla doldurabilirsiniz.
- Test oluşturun ve puanları bir Google E-Tablolar not defterine kaydedin.
- Projenizi Cloud Pub/Sub ile oluşturun ve izleyiciler özelliğini kullanarak sınav sonuçlarını gösteren anlık bir öğrenci lider tablosu oluşturun.