Trong phòng thí nghiệm lập trình này, chúng tôi sẽ giới thiệu cho bạn một trong những cách dễ nhất để viết mã truy cập các công nghệ dành cho nhà phát triển của Google. Tất cả được thực hiện bằng cách áp dụng JavaScript, một ngôn ngữ phát triển web chính thống. Sử dụng Google Apps Script, bạn sẽ viết mã để trích xuất địa chỉ đường phố từ một ô trong Google Trang tính, tạo Google Map dựa trên địa chỉ, sau đó gửi bản đồ dưới dạng tệp đính kèm bằng Gmail. Phần tốt nhất?
Bạn sẽ học được gì
- Cách sử dụng Google Apps Script với các dịch vụ khác nhau của Google, chẳng hạn như Google Trang tính, Google Maps và Gmail
- Phát triển mã bằng trình chỉnh sửa trong trình duyệt cho Apps Script
Những gì bạn cần
- Một trình duyệt web có quyền truy cập vào internet
- Tài khoản Google [Tài khoản Google Workspace có thể cần có sự phê duyệt của quản trị viên]
- Làm quen cơ bản với Google Trang tính
- Khả năng đọc Sheets A1 Notation
2. Sự khảo sát
Bạn sẽ sử dụng codelab/hướng dẫn này như thế nào?
Chỉ đọc qua Đọc và hoàn thành bài tậpBạn đánh giá như thế nào về trải nghiệm của mình với API và công cụ dành cho nhà phát triển Google Workspace?
Mới làm việcTrung cấpThành thạo3. Tổng quan
Bây giờ bạn đã biết phòng thí nghiệm lập trình này nói về cái gì, chính xác thì bạn sẽ làm gì?
- Tìm hiểu một chút về Apps Script, dựa trên JavaScript
- Tạo bảng tính Google Trang tính
- Nhập địa chỉ đường phố vào ô trên cùng bên trái của bảng tính [A1]
- Tìm hiểu cách mở trình chỉnh sửa Apps Script cho bất kỳ tài liệu nào
- Chỉnh sửa mã Apps Script, lưu và chạy nó
- Sử dụng Gmail để xem kết quả
Bắt đầu nào
Google Apps Script là gì?
Google Apps Script là một nền tảng phát triển giúp tạo các tập lệnh và ứng dụng nhỏ tích hợp với Google Workspace nhanh chóng và dễ dàng. Với Apps Script, bạn
- Viết mã bằng JavaScript và truy cập các thư viện tích hợp cho các ứng dụng Google Workspace như Gmail, Lịch, Drive, v.v.
- Không cần cài đặt gì—chúng tôi cung cấp cho bạn trình chỉnh sửa mã ngay trong trình duyệt của bạn và tập lệnh của bạn chạy trên máy chủ của Google
- Không phải lo lắng về các chủ đề phức tạp như bảo mật và quyền truy cập dữ liệu, vì nền tảng sẽ xử lý vấn đề đó cho bạn
GHI CHÚ. Cách viết mã JavaScript nằm ngoài phạm vi của phòng thí nghiệm mã cụ thể này. Mục tiêu của chúng tôi là giúp bạn cảm thấy thoải mái khi sử dụng môi trường phát triển Apps Script và xem các loại ứng dụng mà bạn có thể tạo bằng môi trường đó
Nếu bạn chưa quen với JavaScript, Codecademy cung cấp khóa học JavaScript cơ bản miễn phí. Mặc dù Google không xây dựng khóa học này nhưng nó sẽ bao gồm mọi thứ bạn cần biết
Apps Script có thể được sử dụng để tạo các ứng dụng khác nhau, từ bot trò chuyện đến ứng dụng web. Một trong những cách sử dụng phổ biến nhất là mở rộng chức năng của bảng tính Google Trang tính. Trong phần còn lại của phòng thí nghiệm lập trình này, bạn sẽ tìm hiểu cách sử dụng Apps Script để lấy dữ liệu từ bảng tính và kết nối bảng tính đó với các dịch vụ khác của Google
4. Tạo Google Trang tính và nhập địa chỉ đường phố
Trong Google Trang tính mới, hãy nhập địa chỉ đường phố hợp lệ bằng cách làm theo các hướng dẫn sau
- Tạo Trang tính Google bằng liên kết tiện lợi này [trang tính. Google. com/tạo]. Ngoài ra, hãy truy cập Google Drive của bạn [ổ đĩa. Google. com] và nhấp vào Mới > Google Trang tính > Bảng tính trống
- Trong bảng tính trống, chuyển đến ô đầu tiên ở góc trên bên trái [A1]. Nó sẽ ở cột A và hàng 1. Nếu bạn cần làm quen lại, bạn có thể xem mô tả ký hiệu A1 này
- Nhập địa chỉ đường phố hợp lệ vào ô. Chọn một địa chỉ trên thế giới có vị trí chính xác bằng cách sử dụng địa chỉ đường phố, mã zip/mã bưu chính hoặc kết hợp giữa thành phố và tiểu bang/tỉnh. Đây là một ví dụ về một địa chỉ ở thành phố New York
Đó là tất cả những gì bạn phải làm trong tờ. Hãy mở trình soạn thảo và viết một số mã
5. Chỉnh sửa mã Apps Script
Bây giờ bạn đã có Google Trang tính mới, đã đến lúc chỉnh sửa tập lệnh liên kết của nó. Làm theo những chỉ dẫn này
Mở trình chỉnh sửa tập lệnh
Trên thanh menu, chọn Tiện ích mở rộng > Apps Script để mở trình chỉnh sửa mã trình duyệt cho Apps Script
Trong tab trình duyệt mới, trình chỉnh sửa mã hiển thị tập lệnh giới hạn vùng chứa mặc định cho trang tính. Hàm mặc định có tên
/** @OnlyCurrentDoc */
3 được tạo tự động và con trỏ của bạn được đặt bên trong hàm để bạn có thể bắt đầuGửi email bản đồ Google Map của địa chỉ
Mã "mẫu" bạn được cung cấp trống, vì vậy hãy thay thế nó bằng ứng dụng của chúng tôi
- Trong trình chỉnh sửa tập lệnh, hãy thay thế khối mã
3 mặc định bằng mã sau/** @OnlyCurrentDoc */
/** @OnlyCurrentDoc */
function sendMap[] {
var sheet = SpreadsheetApp.getActiveSheet[];
var address = sheet.getRange['A1'].getValue[];
var map = Maps.newStaticMap[].addMarker[address];
GmailApp.sendEmail['YOUR_EMAIL_ADDR', 'Map', 'See below.', {attachments:[map]}];
}
- Thay thế địa chỉ email giữ chỗ [
5] bằng một địa chỉ hợp lệ. Ví dụ: bạn @ví dụ. com/** @OnlyCurrentDoc */
- Để lưu tập lệnh của bạn, hãy nhấp vào Lưu .
- Để đổi tên dự án Apps Script của bạn, hãy nhấp vào Dự án chưa có tiêu đề, nhập tiêu đề cho dự án của bạn và nhấp vào Đổi tên
đánh giá mã
Cùng xem lại 4 dòng của hàm
/** @OnlyCurrentDoc */
0 tạo nên toàn bộ ứng dụng. Thật thú vị, mã tham chiếu 3 sản phẩm khác nhau của GoogleDòng đầu tiên là một bình luận chú thích ảnh hưởng đến ủy quyền
/** @OnlyCurrentDoc */
Hầu hết các tập lệnh đều yêu cầu người dùng cấp một số quyền trước khi chúng có thể chạy. Các quyền này kiểm soát những gì người dùng cho phép tập lệnh thực hiện. Dòng đầu tiên là một nhận xét chứa chú thích tùy chọn hướng dẫn Apps Script giới hạn quyền truy cập vào bảng tính hiện tại [trái ngược với tất cả các bảng tính của người dùng]. Cách tốt nhất là bao gồm chú thích này khi bạn chỉ làm việc với một tệp duy nhất
Đoạn mã này sử dụng một khai báo hàm JavaScript bình thường cho
/** @OnlyCurrentDoc */
0function sendMap[] {
Dòng tiếp theo gọi Dịch vụ bảng tính có thể truy cập từ Apps Script thông qua đối tượng
/** @OnlyCurrentDoc */
2. Trang tính trả về được gán cho một biến cùng tên. Phương thức /** @OnlyCurrentDoc */
3 nhận tham chiếu đến đối tượng trang tính hiện tại và lưu trữ nó trong biến /** @OnlyCurrentDoc */
4________số 8Với đối tượng
/** @OnlyCurrentDoc */
4, chúng tôi tham chiếu phạm vi ô [của một ô] trong ký hiệu A1 với /** @OnlyCurrentDoc */
6. "Phạm vi" là một nhóm các ô, bao gồm một ô duy nhất như ô /** @OnlyCurrentDoc */
7 [ô mà chúng tôi đã nhập địa chỉ vào]. Để lấy những gì bên trong phạm vi, phương thức /** @OnlyCurrentDoc */
8 trả về giá trị của ô trên cùng bên trái trong phạm vi và gán giá trị cho biến /** @OnlyCurrentDoc */
9. Bạn cũng có thể thử thêm nhiều địa chỉ hơn và đọc từ các ô khác nhau/** @OnlyCurrentDoc */
4Dòng mã thứ ba kết nối với Dịch vụ Google Maps bằng đối tượng
function sendMap[] {
0. function sendMap[] {
1 tạo một đối tượng bản đồ tĩnh và phương thức function sendMap[] {
2 thêm một "ghim" vào bản đồ bằng cách sử dụng địa chỉ trong trang tính/** @OnlyCurrentDoc */
8Cuối cùng, Dịch vụ Gmail thông qua đối tượng
function sendMap[] {
3 gọi phương thức function sendMap[] {
4 để gửi email bao gồm cả văn bản "Xem bên dưới. " và hình ảnh bản đồ dưới dạng tệp đính kèm/** @OnlyCurrentDoc */
16. Chạy ứng dụng Google Trang tính, Bản đồ và Gmail
Sau khi được đặt tên và lưu, đã đến lúc chạy chức năng. Ở đầu trình chỉnh sửa, đảm bảo rằng
/** @OnlyCurrentDoc */
0 được chọn từ danh sách chức năng và nhấp vào ChạyMột tính năng mà các nhà phát triển Apps Script đánh giá cao là bạn không phải viết mã ủy quyền cấp cho chương trình quyền truy cập vào dữ liệu của người dùng. Mặc dù Apps Script quản lý điều này nhưng người dùng ứng dụng của bạn vẫn cần cấp quyền cho tập lệnh truy cập vào bảng tính của họ và gửi email qua Gmail. Hộp thoại ủy quyền đầu tiên trông như thế này
Nhấp vào Xem lại quyền để tiếp tục
Ghi chú. Nếu bạn đang sử dụng gmail. com, bạn có thể nhận được hộp thoại "Ứng dụng này chưa được xác minh" khi bạn sử dụng tập lệnh lần đầu. Google sử dụng điều này để cảnh báo những người dùng có thể đang sử dụng mã từ các tác giả không xác định hoặc không đáng tin cậy. Nếu bạn thấy hộp thoại này, bạn có thể tiếp tục vì bạn là tác giả tập lệnh. Làm theo lời nhắc trên màn hình để tiếp tục ủy quyền tập lệnh
- Trong hộp thoại ứng dụng chưa được xác minh, nhấp vào Nâng cao
- Nhấp vào Chuyển đến tên dự án của bạn [không an toàn]
- Nhấp vào Cho phép
Trong suốt buổi học mã này, bạn có thể nhận được một số lời nhắc về quyền. Bạn có thể đọc thêm về quy trình này trong Ủy quyền cho các dịch vụ của Google
Tiếp theo, bạn sẽ nhận được cửa sổ hộp thoại OAuth2 yêu cầu quyền truy cập trang tính của bạn và gửi email thay mặt bạn
Sau khi bạn cấp quyền, tập lệnh sẽ chạy đến khi hoàn thành
Kiểm tra tài khoản email mà bạn đã gửi tin nhắn của mình và bạn sẽ tìm thấy một email có chủ đề là "Bản đồ" và một tin nhắn giống như thế này
Khi bạn mở tệp đính kèm trong email, bạn sẽ nhận được Google Map có ghim địa chỉ bạn đã nhập vào trang tính
Chỉ với bốn dòng mã, bạn đã truy cập 3 sản phẩm khác nhau của Google một cách có ý nghĩa
7. tài nguyên bổ sung
Mã đặc trưng trong phòng thí nghiệm mã này cũng có sẵn tại repo GitHub của nó tại github. com/googleworkspace/apps-script-intro-codelab. Dưới đây là các tài nguyên khác để giúp bạn tìm hiểu sâu hơn về tài liệu có trong phòng thí nghiệm lập trình này và để khám phá các cách khác để truy cập các công cụ dành cho nhà phát triển của Google theo cách lập trình