Việc thiết lập dự án Apps Script để gọi trực tiếp API Google Biểu mẫu thông qua lệnh gọi REST là rất đơn giản. Giả sử bạn đã định cấu hình một dự án Google Cloud, hãy làm như sau:
- Tạo một dự án Apps Script mới.
- Thay đổi số dự án trên Google Cloud được liên kết để khớp với dự án bạn đã bật cho API Google Biểu mẫu.
- Chỉnh sửa tệp kê khai (
appsscript.json
) để thêm các phạm vi OAuth cần thiết. - Thêm mã Apps Script để tìm nạp mã thông báo OAuth và thực hiện lệnh gọi REST bằng mã thông báo.
Dưới đây là hướng dẫn nhanh về các bước này.
Tạo và định cấu hình dự án Apps Script mới
- Sử dụng cùng một mã Google mà bạn đã dùng để định cấu hình dự án GCP, truy cập vào Trang tổng quan Apps Script, rồi nhấp vào Dự án mới.
- Sau khi dự án mở ra, hãy nhấp vào Project Settings (Cài đặt dự án).
- Chọn hộp đánh dấu Hiển thị tệp kê khai "appsscript.json" trong trình chỉnh sửa.
- Trong mục Dự án Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án rồi nhập số dự án GCP mà bạn đã định cấu hình cho API Biểu mẫu.
Dự án Apps Script của bạn hiện đã được định cấu hình để truy cập vào API Google Biểu mẫu. Bước cần thiết tiếp theo là thêm phạm vi OAuth phù hợp.
Thêm phạm vi OAuth
Để tạo mã thông báo OAuth có phạm vi phù hợp trong Apps Script, bạn cần đặt phạm vi bắt buộc trong tệp kê khai của dự án.
- Trong trình chỉnh sửa, hãy mở
appsscript.json
. Thêm phạm vi vào phần nội dung của tệp kê khai.
{ ... "oauthScopes": [ "https://www.googleapis.com/auth/script.external_request", "https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/drive.readonly", "https://www.googleapis.com/auth/forms.body", "https://www.googleapis.com/auth/forms.body.readonly", "https://www.googleapis.com/auth/forms.responses.readonly" ], ... }
Nhấp vào
Save project (Lưu dự án) và sửa mọi lỗi cú pháp (nếu cần). Dự án của bạn hiện có thể gọi API Google Biểu mẫu thông qua lệnh gọi REST.
Thêm mã Apps Script để gọi API
Trước khi viết mã để gọi một biểu mẫu, bạn cần xác định một biểu mẫu mà mình sở hữu có phản hồi và ghi lại mã biểu mẫu. Bạn có thể tìm thấy mã biểu mẫu trong URL khi chỉnh sửa biểu mẫu:
https://docs.google.com/forms/d/<FORM_ID>/edit
Để gọi API, bạn cần sử dụng lệnh gọi UrlFetchApp
của Apps Script.
Mở Code.gs và thêm mã sau:
Thay thế
YOUR_FORM_ID
bằng giá trị mà bạn đã lưu ý trước đó.Ví dụ:
var formId = 'tL5ygBC8zpbTnTp76JCZdIg80hA-cnpbTnTjnsewCKJH';
Nhấp vào
Save project (Lưu dự án) và sửa mọi lỗi cú pháp (nếu cần).
Kiểm thử mã
- Nhấp vào Run (Chạy).
- Uỷ quyền dự án nếu cần bằng cách sử dụng cùng một mã Google như trước đây.
Sau khi quá trình bắt đầu, bạn sẽ thấy phản hồi trong Nhật ký thực thi tương tự như sau:
Execution started Calling the Forms API! OAuth token is: ya29.a0ARrdaM8IMjtlv… formsAPIUrl is: https://forms.googleapis.com/v1beta/forms/…/responses Response from Forms.responses was: { "responses": [ { "responseId":"...", "createTime": "2021-03-25T01:23:58.146Z", "lastSubmittedTime": "2021-03-25T01:23:58.146607Z", "answers": { "1e9b0ead": { "questionId": "1e9b0ead", "textAnswers": { "answers": [ { "value": "Red" } ] } }, "773ed8f3": { "questionId": "773ed8f3", "textAnswers": { "answers": [ { "value": "Tesla" } ] } } } } ] } Execution completed
Các bước tiếp theo
Sau khi bạn gọi thành công API bằng Apps Script, hãy tham khảo tài liệu tham khảo và thử nghiệm bằng cách thực hiện các lệnh gọi khác đến API đó.