Trang này cung cấp thông tin tổng quan về ví dụ về ứng dụng web Apps Script cho API Google Biểu mẫu.
Điều kiện tiên quyết
- Bật API Biểu mẫu trong dự án trên Google Cloud.
- Thiết lập một dự án Apps Script mới như mô tả trong tệp README GitHub cho ứng dụng web mẫu.
Tổng quan
API biểu mẫu cho phép mọi ứng dụng đã xác thực truy cập vào API trực tiếp bằng REST.
Vì Apps Script giúp bạn dễ dàng lấy cả Mã truy cập OAuth hợp lệ và thực hiện lệnh gọi REST, nên việc tích hợp trực tiếp Apps Script với API Biểu mẫu trở nên đơn giản. Apps Script đã cung cấp một Dịch vụ biểu mẫu hiện có, cho phép tập lệnh tạo, truy cập và sửa đổi Google Biểu mẫu. Tuy nhiên, nếu bạn muốn sử dụng API Biểu mẫu ngay từ Apps Script, hãy thiết lập quyền truy cập OAuth như sau:
Nhận mã truy cập OAuth có phạm vi và đã xác thực.
ScriptApp.getOAuthToken();Đưa mã thông báo OAuth vào đối số options (tuỳ chọn) được cung cấp trong mọi lệnh gọi REST đến API.
UrlFetchApp.fetch(Url, options);
Hãy xem bài viết Thiết lập dự án Apps Script để biết ví dụ về quá trình này trong thực tế. Hướng dẫn thiết lập nêu chi tiết hệ thống ống nước cơ bản cần thiết để gọi API. Tuy nhiên, để cung cấp quyền truy cập trực quan vào API cho người dùng cuối, bạn cũng có thể dùng thử và sửa đổi ứng dụng web mẫu của chúng tôi.
Ví dụ về cách sử dụng của ứng dụng web
Bạn có thể tìm thấy một ứng dụng web mẫu hoàn chỉnh gọi trực tiếp tất cả các phương thức API Biểu mẫu trên GitHub cho mục đích minh hoạ.
Chạy ứng dụng web
Sau khi thiết lập dự án và triển khai dự án dưới dạng ứng dụng web, bạn có thể thử một số thao tác cơ bản.
Tạo biểu mẫu mới bằng cách nhấp vào nút Tạo biểu mẫu.
Biểu mẫu mới giờ đây sẽ xuất hiện trong trường Mã biểu mẫu: và bạn có thể mở biểu mẫu đó bằng cách nhấp vào Mở trong Biểu mẫu.
Sau khi mở biểu mẫu mới trong một cửa sổ riêng, hãy thử thêm một vài câu hỏi theo cách thủ công, sau đó nhấp vào Nhận biểu mẫu theo mã nhận dạng và bạn sẽ thấy các câu hỏi mới trong kết quả JSON ở bên phải.
Hãy thoải mái khám phá các phương thức khác có sẵn trong ứng dụng và quan sát kết quả ở bên phải cho mỗi thao tác.
Làm việc với đồng hồ Biểu mẫu
Ngoài ra, hãy chú ý đến các nút của đồng hồ biểu mẫu. Các đồng hồ này sử dụng tính năng đồng hồ API Biểu mẫu và thực hiện các thao tác cơ bản để tạo, liệt kê, xoá và gia hạn đồng hồ. Bạn cần thiết lập một dự án có các chủ đề Cloud Pub/Sub để sử dụng các chủ đề đó.
Để biết thêm thông tin về đồng hồ Forms API và Cloud Pub/Sub, hãy xem phần Thiết lập và nhận thông báo đẩy.
Các bước tiếp theo
Hãy thử tuỳ chỉnh ứng dụng mẫu cho phù hợp với nhu cầu của bạn. Dưới đây là một số ví dụ:
- Tạo một ngân hàng câu hỏi trong Google Trang tính, sau đó sử dụng dịch vụ SpreadsheetApp của Apps Script để tìm nạp các câu hỏi trên một trang tính nhằm điền sẵn những biểu mẫu mới.
- Ngoài ra, ngân hàng câu hỏi của bạn có thể nằm trong cơ sở dữ liệu SQL, nơi bạn có thể sử dụng Dịch vụ JDBC của Apps Script để điền các câu hỏi từ cơ sở dữ liệu vào biểu mẫu.
- Tạo bài kiểm tra và lưu điểm vào sổ điểm trên Google Trang tính.
- Thiết lập dự án của bạn với Cloud Pub/Sub và sử dụng tính năng đồng hồ để tạo bảng xếp hạng học viên theo thời gian thực nhằm hiện kết quả bài kiểm tra.