Trang tính v4 api json

Tại Google I/O 2016, chúng tôi đã ra mắt API Google Trang tính mới —hãy nhấp vào đây để xem toàn bộ thông báo. API cập nhật bao gồm nhiều tính năng mới không có trong các phiên bản trước, bao gồm quyền truy cập vào chức năng có trong giao diện người dùng trên thiết bị di động và máy tính để bàn của Sheets. Video DevByte mới nhất của tôi chỉ cho các nhà phát triển cách lấy dữ liệu vào và ra khỏi Google Trang tính theo chương trình, xem qua một tập lệnh đơn giản để đọc các hàng từ cơ sở dữ liệu quan hệ và chuyển dữ liệu sang một Google Trang tính hoàn toàn mới

Hãy cùng xem qua đoạn mã có trong video. Giả sử rằng

npm install googleapis express
5 đã được thiết lập làm điểm cuối dịch vụ API,
npm install googleapis express
6 là ID của Trang tính để ghi vào và
npm install googleapis express
7 là một mảng có tất cả các hàng trong cơ sở dữ liệu, đây là lệnh gọi duy nhất mà nhà phát triển cần thực hiện để ghi dữ liệu thô đó vào

Đang tải

Đọc các hàng trong Trang tính thậm chí còn dễ dàng hơn. Với lại

npm install googleapis express
5 và
npm install googleapis express
6, đây là tất cả những gì bạn cần để đọc và hiển thị các hàng đó

Đang tải

Trang tính v4 api json

Nếu bạn đã sẵn sàng để bắt đầu, hãy xem Python hoặc các hướng dẫn bắt đầu nhanh khác bằng nhiều ngôn ngữ trước khi xem DevByte. Nếu bạn muốn tìm hiểu sâu hơn về mã có trong video, hãy xem bài đăng tại blog Python của tôi. Sau khi bạn bắt đầu sử dụng API, một trong những thách thức mà nhà phát triển gặp phải là xây dựng tải trọng JSON để gửi các lệnh gọi API—các mẫu hoạt động phổ biến thực sự có thể giúp bạn giải quyết vấn đề này. Cuối cùng, nếu bạn đã sẵn sàng bắt đầu với một ví dụ cụ thể hơn, hãy xem phòng thí nghiệm mã JavaScript của chúng tôi, nơi bạn sẽ viết một Node mẫu. js quản lý đơn đặt hàng của khách hàng cho một công ty đồ chơi, cơ sở dữ liệu được sử dụng trong DevByte này, giúp bạn chuẩn bị cho phòng thí nghiệm mã

Chúng tôi hy vọng tất cả các tài nguyên này sẽ giúp các nhà phát triển tạo ra các ứng dụng tuyệt vời và các công cụ tuyệt vời với API Google Trang tính mới. Vui lòng đăng ký kênh của chúng tôi, cung cấp cho chúng tôi phản hồi của bạn bên dưới và cho chúng tôi biết chủ đề bạn muốn xem trong các tập tiếp theo

API Google Trang tính cho phép chúng tôi đọc, viết và cập nhật dữ liệu của bảng tính. Chúng tôi cũng có thể sử dụng nó để hiển thị giao diện người dùng (UI) bằng cách tìm nạp dữ liệu từ Google Trang tính, sau đó dữ liệu này sẽ đóng vai trò là cơ sở dữ liệu. API Google Trang tính giúp nhà phát triển nhập dữ liệu vào bảng tính và xây dựng ứng dụng tương tác với Google Trang tính, tối đa hóa các chức năng và tăng năng suất

Trong hướng dẫn API Google Trang tính dành cho người mới bắt đầu này, bạn sẽ tìm hiểu cách sử dụng API Google Trang tính để thực hiện các thao tác CRUD cơ bản

Điều kiện tiên quyết cho Hướng dẫn API Google Trang tính

Hướng dẫn này giả định rằng bạn có

  • hiểu biết cơ bản về JavaScript và Node. js,
  • Nút. js và npm được cài đặt trên máy tính của bạn,
  • một trình chỉnh sửa mã (chẳng hạn như Mã VS) và
  • tài khoản Google

Thiết lập dự án

Để sử dụng API Google Trang tính, bạn cần có Dự án Google Cloud Platform đã bật API, cũng như thông tin đăng nhập ủy quyền. Để có được những thứ đó, hãy làm theo các bước dưới đây

Bước 1. Tạo một dự án mới

Trước tiên, hãy mở Google Cloud Console, sau đó tạo một dự án mới

Trang tính v4 api json

Bước 2. Kích hoạt API và Dịch vụ

Ở trên cùng bên trái, nhấp vào Menu ☰ > API và Dịch vụ > Dịch vụ và API đã bật

Sau đó nhấp vào nút **+ Kích hoạt API và Dịch vụ **

Trang tính v4 api json

Bước 3. Tạo một tài khoản dịch vụ

Bây giờ API đã được bật, nó sẽ đưa bạn đến một trang nơi bạn có thể định cấu hình cài đặt cho API

Trong thanh bên trái, nhấp vào tab Thông tin xác thực, sau đó nhấp vào nút Tạo thông tin xác thực ở trên cùng

Tiếp theo, chọn Tài khoản dịch vụ trong menu thả xuống

Trang tính v4 api json

Trong màn hình tiếp theo, hãy cung cấp chi tiết tài khoản dịch vụ được yêu cầu;

Trang tính v4 api json

Nhấp vào Continue và Done tương ứng trên hai hộp thoại tiếp theo

Bây giờ, tài khoản dịch vụ mới tạo của bạn sẽ có trên trang thông tin đăng nhập

Sao chép địa chỉ email của tài khoản dịch vụ vào khay nhớ tạm, vì sau này chúng tôi sẽ cần địa chỉ đó để chia sẻ bảng tính với tài khoản này

Bạn sẽ được chuyển đến màn hình tiếp theo, nơi chúng tôi sẽ tạo một khóa mới. Để làm như vậy, bấm vào tab Phím, rồi bấm vào nút Thêm khóa

Chọn tùy chọn Tạo khóa mới, sau đó chọn loại khóa của JSON

Trang tính v4 api json

Cuối cùng, đổi tên tệp JSON đã tải xuống và di chuyển tệp đó vào thư mục dự án của bạn. Tệp khóa này chứa thông tin đăng nhập của tài khoản dịch vụ mà chúng tôi cần trong Nút của chúng tôi. js để truy cập bảng tính từ Google Trang tính

Cách sử dụng API Google Trang tính

Bây giờ, chúng ta đã hoàn tất việc thiết lập dự án và thông tin đăng nhập của dự án trong bảng điều khiển đám mây của Google, hãy khám phá cách sử dụng các chức năng API cơ bản trong Google Trang tính

Tạo một bảng tính

Trước khi đi sâu vào mã, hãy truy cập Google Trang tính và tạo một bảng tính mới. Nhập một số dữ liệu giả để chúng tôi có thứ gì đó để tìm nạp trong khi kiểm tra API

Trang tính v4 api json

Bây giờ, hãy thêm địa chỉ email của tài khoản dịch vụ và gán cho nó vai trò Trình chỉnh sửa, cho phép nó đọc, ghi, cập nhật và xóa dữ liệu

Nhấp vào nút Chia sẻ ở góc trên cùng bên phải. Điều này sẽ mở một phương thức nơi chúng tôi sẽ chia sẻ bảng tính với tài khoản dịch vụ. Đảm bảo bỏ chọn hộp kiểm Thông báo cho mọi người

Trang tính v4 api json

Nhấp vào nút Chia sẻ để chia sẻ bảng tính với tài khoản dịch vụ

Cài đặt ứng dụng

Bây giờ chúng ta đã hoàn tất việc cấu hình, hãy bắt đầu viết mã. Mở trình chỉnh sửa mã của bạn và tạo một thư mục dự án mới. Tôi sẽ sử dụng Mã VS

Sao chép và dán tệp khóa đã tải xuống vào thư mục gốc của thư mục. Đổi tên tệp thành một tệp đơn giản hơn, chẳng hạn như các phím. json

Tiếp theo, điều hướng đến thư mục gốc của dự án, mở thiết bị đầu cuối tích hợp trong Mã VS và chạy lệnh này

npm init -y

Lệnh này sẽ khởi tạo thư mục và tạo một gói rỗng. json, xác định thông tin quan trọng về dự án, chẳng hạn như phần phụ thuộc và phiên bản dự án

Tiếp theo, hãy cài đặt một vài phụ thuộc

  • , để truy cập API Google Trang tính
  • Express, để quản lý máy chủ và định tuyến
  • gật đầu, để phát triển cục bộ để máy chủ sẽ khởi động lại khi chúng tôi lưu tệp
npm install googleapis express

Khi cài đặt xong, hãy chạy đoạn mã sau để cài đặt gật đầu dưới dạng phần phụ thuộc của nhà phát triển

npm install nodemon --save-dev

Sau khi chạy các lệnh, bạn sẽ nhận được gói khóa. json và thư mục node_modules

++Bây giờ, để cấu hình gật đầu khởi động lại máy chủ trên mỗi tệp lưu, hãy mở gói. json và thêm đoạn mã sau

"scripts": {
    "dev": "nodemon ."
  },

Điều này sẽ cho phép chúng tôi chạy máy chủ dev bằng lệnh npm run dev

Bây giờ, gói của bạn. tệp json sẽ trông như thế này

{
  "dependencies": {
    "express": "^4.18.1",
    "googleapis": "^101.0.0",
  },
  "scripts": {
    "dev": "nodemon ."
  },
  "name": "quickstart",
  "version": "1.0.0",
  "main": "index.js",
  "keywords": [],
  "author": "",
  "license": "ISC",
  "description": "",
  "devDependencies": {
    "nodemon": "^2.0.19"
  }
}

Lưu ý rằng các phiên bản phụ thuộc có thể khác nhau

Tích hợp API Google Trang tính

Tiếp theo, tạo một tệp có tên là chỉ mục. js trong thư mục dự án. mở chỉ mục. js và nhập các phụ thuộc mà chúng tôi vừa cài đặt

const express = require("express");

const { google } = require("googleapis");

Khởi tạo Express và lắng nghe máy chủ. Tôi đang sử dụng cổng 8080, nhưng bạn có thể chọn bất kỳ cổng nào

const app = express();
const port = 8080;

//This allows us to parse the incoming request body as JSON
app.use(express.json());

// With this, we'll listen for the server on port 8080
app.listen(port, () => console.log(`Listening on port ${port}`));

Tiếp theo, thêm đoạn mã sau

async function authSheets() {
  //Function for authentication object
  const auth = new google.auth.GoogleAuth({
    keyFile: "keys.json",
    scopes: ["https://www.googleapis.com/auth/spreadsheets"],
  });

  //Create client instance for auth
  const authClient = await auth.getClient();

  //Instance of the Sheets API
  const sheets = google.sheets({ version: "v4", auth: authClient });

  return {
    auth,
    authClient,
    sheets,
  };
}

Hãy chia đoạn mã trên thành các bit

Trước tiên, chúng tôi đã tạo một đối tượng xác thực Google mới để chúng tôi có thể ủy quyền cho yêu cầu API. Điều này hoạt động bằng cách chuyển vào keyFile, đó là các khóa. json (giả sử tệp được lưu trữ ở cấp gốc của dự án) và thuộc tính phạm vi chỉ định Google API mà chúng tôi đang sử dụng

Thứ hai, biến authClient lưu trữ chi tiết tài khoản dịch vụ (ví dụ ứng dụng khách) từ phương thức getClient() sau khi các chi tiết đã được xác minh trong đối tượng auth

Thứ ba, chúng tôi tạo một phiên bản của Google Sheets API. Nó nhận một đối tượng có hai thuộc tính. phiên bản (phiên bản hiện tại, trong trường hợp của chúng tôi là v4) và auth, authClient mà chúng tôi đã tạo

Cuối cùng, chúng tôi trả về các biến để chúng tôi có thể truy cập các giá trị bảng tính trong bất kỳ tuyến nào của ứng dụng

Đọc dữ liệu từ bảng tính

Bây giờ, để lấy dữ liệu từ bảng tính, chúng ta sẽ sử dụng các trang tính. bảng tính. giá trị. get, nhận hai tham số đường dẫn bắt buộc—bảng tínhId và phạm vi—và lưu trữ chúng trong một biến phản hồi

________số 8

Chúng tôi trích xuất bảng tínhId từ URL của bảng tính và lưu trữ nó trong một biến toàn cục, id

Trang tính v4 api json

Văn bản được gạch chân màu đỏ là ID bảng tính

const id = "12fSSjNTpDtTJ8vF4T3LRYe36WjPEfn1_sr_lSSpZJUo";

Mặc dù phạm vi xác định phạm vi ô để đọc, ở đây chúng tôi sử dụng tên bảng tính. Mỗi tệp bảng tính có ít nhất một trang tính, được xác định bằng tên trang tính. Trong ví dụ của chúng tôi, chúng tôi đang sử dụng tên trang tính là Trang tính 1 mà bạn có thể tìm thấy ở dưới cùng bên trái của bảng tính

Bạn cũng có thể giới hạn phạm vi của trang tính bằng cách thêm tên trang tính, ký hiệu dấu chấm than và sau đó là phạm vi cột (e. g. , Tờ1. A1. C5)

các tờ. bảng tính. giá trị. phương thức get có ba tham số truy vấn tùy chọn khác

  • majorDimension xác định thứ nguyên chính của các giá trị, hàng hoặc cột. Mặc định là ROWS
  • valueRenderOption xác định cách các giá trị sẽ được hiển thị trong đầu ra. Mặc định là FORMATTED_VALUE
  • dateTimeRenderOption xác định cách hiển thị ngày, giờ và thời lượng trong đầu ra. Mặc định là SERIAL_NUMBER

Bây giờ, hãy chạy lệnh sau trong thiết bị đầu cuối để khởi động máy chủ

npm install googleapis express
0

Trang tính v4 api json

Sau đó, hãy truy cập trình duyệt của bạn và nhập http. //máy chủ cục bộ. 8080/. Kết quả phải là một cái gì đó như thế này

Trang tính v4 api json

Nếu nó trông không được căn chỉnh như thế này, hãy cài đặt JSONVue để định dạng các tệp JSON của bạn trong trình duyệt. Với điều này, chúng tôi đã đọc thành công dữ liệu từ bảng tính của mình

Viết và cập nhật dữ liệu vào bảng tính

Để nối thêm dữ liệu sau một bảng dữ liệu trong một trang tính, hãy sử dụng các trang tính. bảng tính. giá trị. phương thức chắp thêm, lấy ID bảng tính, phạm vi ô để ghi vào, giá trị do người dùng nhập và đối tượng tài nguyên chứa thông tin để chèn vào các hàng

npm install googleapis express
1

Thuộc tính valueInputOption xác định cách diễn giải dữ liệu đầu vào. Các giá trị sẽ được phân tích cú pháp theo cách người dùng nhập chúng vào giao diện người dùng

Đối tượng tài nguyên có một con, các giá trị, là một mảng dữ liệu sẽ được thêm vào các trang tính. Ở đây, chúng tôi đang thêm một hàng mới với các giá trị cho tên học sinh, giới tính và cấp lớp

Lưu mã và truy cập Google Trang tính, nơi bạn sẽ thấy rằng mục nhập mới đã được thêm vào. Nếu không, hãy làm mới máy chủ cục bộ rồi quay lại Google Trang tính

Trang tính v4 api json

Ngoài ra còn có tùy chọn sử dụng bảng tính. giá trị. yêu cầu cập nhật. Điều này cho phép chúng tôi ghi dữ liệu vào một phạm vi được chỉ định. Ví dụ: đoạn mã sau sẽ cập nhật cấp lớp của Alexandra thành "2. Sinh viên năm hai"

npm install googleapis express
2

Trang tính v4 api json

Xóa dữ liệu khỏi Google Trang tính

Sử dụng bảng tính. giá trị. xóa, chúng ta có thể xóa các giá trị khỏi bảng tính. Để làm điều đó, hãy chỉ định ID và phạm vi bảng tính. Mã bên dưới sẽ xóa tất cả các giá trị từ hàng A6 đến C6

npm install googleapis express
3

Cập nhật định dạng bảng tính

Với API Google Trang tính, chúng tôi có thể cập nhật định dạng của ô và phạm vi trong bảng tính

Đoạn mã sau xác định kiểu cho từng ô cho phạm vi được xác định. Ở đây, chúng tôi thêm một đường viền nét đứt với màu đỏ

npm install googleapis express
4

Đây là cách bố trí kết quả

Trang tính v4 api json

Câu hỏi thường gặp về API Google Trang tính

Dưới đây là một số câu hỏi thường gặp về Google Sheets API

Tôi có thể sử dụng API Google Trang tính miễn phí không?

Sử dụng API Google Trang tính là miễn phí, nhưng mỗi người dùng có giới hạn sử dụng. Giới hạn sử dụng API Google Trang tính là hạn ngạch và giới hạn do Google áp đặt để đảm bảo API của họ được sử dụng một cách công bằng và để bảo vệ hệ thống của họ

Trang tính v4 api json

Tuy nhiên, bạn không được sử dụng hết giới hạn này trừ khi ứng dụng của bạn có nhiều người dùng. Nếu bạn vượt quá giới hạn, bạn sẽ nhận được 429. Lỗi quá nhiều yêu cầu. Nếu điều này xảy ra, hãy thử sử dụng

Làm cách nào để sử dụng API trong Google Trang tính?

Giống như việc bạn có thể sử dụng API Google Trang tính để đọc và viết Google Trang tính, bạn cũng có thể tận dụng khả năng kết nối của nó để sử dụng các API khác

Lấy ví dụ, tiện ích bổ sung Fusebit cho Google Trang tính. Fusebit cho phép bạn sử dụng Node. js, npm và Fusebit Connectors để nhanh chóng kết nối với bất kỳ API hoặc nguồn dữ liệu nào với ma sát thấp và tính linh hoạt của mã. Điều này mang lại cho bạn rất nhiều siêu năng lực, bao gồm nhận danh bạ từ Salesforce, truy vấn dữ liệu trong MongoDB, nhập công ty từ HubSpot, nhập bản ghi từ MySQL, tải xuống hóa đơn chưa thanh toán từ QuickBooks, v.v. Kiểm tra blog Fusebit để xem bạn có thể đạt được những gì khác với Tiện ích bổ sung Google Sheets của Fusebit

Phần kết luận

Trong hướng dẫn này, chúng ta đã khám phá một số chức năng cơ bản của API Google Trang tính và bạn đã thấy việc thiết lập nó dễ dàng như thế nào. Nhưng đó không phải là tất cả. Từ đây, bạn có thể tạo mọi thứ đơn giản từ bản sao Google Biểu mẫu thành ứng dụng yêu cầu video hoặc bạn có thể sử dụng nó cho một thứ gì đó phức tạp hơn như sử dụng nó làm cơ sở dữ liệu từ nơi ứng dụng tìm nạp dữ liệu và hiển thị ở giao diện người dùng

Tôi hy vọng bạn tìm thấy bài đăng này hữu ích và sâu sắc. Nếu bạn muốn khám phá các chức năng khác, hãy xem tài liệu. Mã hóa vui vẻ

Bài đăng này được viết bởi Israel Oyetunji. Israel là nhà phát triển giao diện người dùng có sở trường tạo giao diện người dùng hấp dẫn và trải nghiệm tương tác. Anh ấy đã chứng minh được kinh nghiệm phát triển các trang web tập trung vào người tiêu dùng bằng cách sử dụng HTML, CSS, Javascript, React JS, SASS và các công nghệ liên quan. Anh ấy thích viết về công nghệ và tạo các hướng dẫn cách làm cho các nhà phát triển

Google Trang tính có thể lấy dữ liệu từ API không?

Sau khi bạn đã thiết lập kết nối API với Google Trang tính, hãy nhấp vào Lưu và chạy để tải dữ liệu vào bảng tính của bạn .

Google Trang tính có thể nhập JSON không?

Có, Google Trang tính có thể nhập tệp JSON , bạn có thể làm điều đó với Google Apps Script hoặc các ứng dụng không cần mã của bên thứ ba như Zapier.

Bạn có thể gọi API REST từ Google Trang tính không?

Gọi API REST trong Google Trang tính dễ dàng như cài đặt ứng dụng Apipheny, sau đó mở ứng dụng trong Google Trang tính của bạn, nhập yêu cầu API của bạn và nhấp vào “Chạy” . Tiếp tục đọc hướng dẫn về cách nhập dữ liệu API REST vào Google Trang tính.