Bu sayfada, Google Forms API için Apps Komut Dosyası 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ış
Forms API, kimliği doğrulanmış herhangi bir istemcinin API'ye doğrudan REST kullanarak erişmesine olanak tanır.
Apps Komut Dosyası, hem geçerli bir OAuth Erişim Jetonu almak hem de REST çağrıları yapmak için kolay bir yol sunduğundan Apps Komut Dosyası'nı doğrudan Forms API ile entegre etmek kolaydır. Apps Komut Dosyası, komut dosyalarının Google Formlar dosyası oluşturmasına, düzenlemesine ve Google Formlar'a erişmesine olanak tanıyan mevcut bir Formlar Hizmeti'ni zaten sunmaktadır. Ancak, Formlar API'yi doğrudan Apps Komut Dosyası'ndan kullanmayı tercih ederseniz OAuth erişimini aşağıdaki şekilde 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);
Bunun uygulama örneğini görmek için Apps Komut Dosyası projesi oluşturma bölümüne bakın. Kurulum kılavuzu, API'yi çağırmak için gereken temel tesisat sistemiyle ilgili ayrıntıları içerir. Ancak, son kullanıcılar için API'ye sezgisel erişim sağlamak amacıyla örnek web uygulamamızı da deneyip değiştirebilirsiniz.
Web uygulaması örnek kullanımı
Tüm Forms API yöntemlerini doğrudan çağıran eksiksiz bir örnek web uygulamasını, demo amacıyla GitHub'da bulabilirsiniz.
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 ve Formlarda aç'ı tıklayarak açabilirsiniz.
Yeni formu ayrı bir pencerede açtıktan sonra manuel olarak birkaç soru eklemeyi deneyin. Ardından Kimliğe Göre Form Al'ı tıklayın. Yeni sorularınızı sağdaki JSON çıkışında görürsünüz.
Uygulamadaki diğer yöntemleri keşfedebilir ve her işlem için sağdaki çıkışı inceleyebilirsiniz.
Formlar saatleriyle çalışma
Ayrıca form saatleri düğmelerine de dikkat edin. Bunlar, Formlar API'si saatler özelliğini kullanır ve kol saati oluşturmak, listelemek, silmek ve yenilemek için temel işlemleri gerçekleştirir. Bu konuları kullanmak için Cloud Pub/Sub konularını içeren bir proje oluşturmanız gerekir.
Forms API saatleri ve Cloud Pub/Sub hakkında daha fazla bilgi edinmek için Push bildirimlerini ayarlama ve alma bölümüne bakın.
Sonraki adımlar
Örnek uygulamayı ihtiyaçlarınıza göre özelleştirmeyi deneyin. Aşağıda birkaç örnek verilmiştir:
- Google e-tablosunda bir soru bankası oluşturun ve yeni formları doldurmak amacıyla e-tablodan soruları getirmek için Apps Komut Dosyası SpreadsheetApp hizmetini kullanın.
- Alternatif olarak, soru bankanız bir SQL veritabanında bulunabilir. Burada, Apps Komut Dosyası JDBC Service'i kullanarak formları veritabanındaki sorularla doldurabilirsiniz.
- Bir test oluşturun ve puanları bir Google E-Tablosu not defterine kaydedin.
- Cloud Pub/Sub ile projenizi oluşturun ve test sonuçlarını göstermek üzere gerçek zamanlı bir öğrenci skor tablosu oluşturmak için saatler özelliğini kullanın.