API Google Apps Script Sheets

Đây là tập lệnh mẫu để sắp xếp các ô trên Bảng tính Google với màu nền bằng Google Apps Script

Thật không may, trong giai đoạn hiện tại, có vẻ như

{type: Int}

2 của Phạm vi loại không thể sắp xếp trực tiếp theo màu nền của các ô. Nhưng khi API Trang tính được sử dụng, mục tiêu này có thể đạt được. Ở đây, "SortRangeRequest" của phương pháp "bảng tính. batchUpdate" trong Sheets API được sử dụng

lưu lượng

Quy trình của tập lệnh mẫu này như sau

1. Lấy màu nền từ các ô
2. Tạo nội dung yêu cầu để sử dụng phương thức batchUpdate của Sheets API
3. Yêu cầu API Trang tính bằng cách sử dụng nội dung yêu cầu

kịch bản mẫu

Vui lòng sao chép và dán tập lệnh sau vào trình chỉnh sửa tập lệnh của tập lệnh được liên kết vùng chứa của Bảng tính. Và. Bằng cách này, Sheets API có thể được sử dụng với Google Apps Script

Bắt đầu

Hướng dẫn và hướng dẫn để đưa bạn từ viết tập lệnh đầu tiên đến xây dựng ứng dụng của bạn

Tìm hiểu thêm »

Tập lệnh mẫu

Từ các công cụ năng suất đến tự động hóa doanh nghiệp, hãy xem những gì bạn có thể xây dựng với Google Apps Script

Tìm hiểu thêm »

Tài liệu tham khảo dành cho nhà phát triển

Hoàn thành tài liệu với mọi thứ bạn cần biết khi xây dựng bằng Google Apps Script

Tìm hiểu thêm »

Đôi khi bạn cần xây dựng một API. Có thể bạn đang xây dựng một ứng dụng, có thể là bot Slack hoặc có thể là một cú hạ gục trên Zapier. Google Trang tính và Google Apps Script có mọi thứ bạn cần để tạo một API đơn giản

Nếu bạn giống tôi, bạn đã tạo API cho tất cả những thứ ngẫu nhiên. Nguyên nhân cao quý, chẳng hạn như phần phụ trợ cho ứng dụng bạn đã tạo hoặc cho những thứ hoàn toàn ngẫu nhiên, chẳng hạn như công cụ tạo ý tưởng kinh doanh khởi nghiệp của tôi, là cơ sở của ví dụ này

Xem trước lén lút. Bạn có thể xem kết quả của API bằng cách nhấp vào đây

Trên thực tế, có một lần tôi đã sử dụng API Google Trang tính và Zapier để sao chép bạn mình vào bot Slack… đó có thể là cách sử dụng (/lạm dụng) API yêu thích nhất của tôi mọi thời đại

Đây là cách xây dựng một API đơn giản mà bạn có thể gửi yêu cầu HTTP GET và nhận câu trả lời từ. Nó chạy cơ sở dữ liệu hoàn toàn dựa trên Google Trang tính

Các bước tạo API trong Google Sheets

Thiết lập Google Trang tính của bạn với dữ liệu và logic cơ bản của bạn

Đây là mẫu Google Trang tính mà tôi có, chứa đầy các khối xây dựng cho các ý tưởng khởi nghiệp ngẫu nhiên. Nó tạo ra những ý tưởng khởi nghiệp như “Tinder cho chó” hoặc “Thuốc say sóng VR cho công nhân bốc xếp sử dụng IoT”

Dữ liệu là ba cột tạo thành khởi động ngẫu nhiên bằng cấu trúc “X for Y” hoặc “X for Y using Z”. Vâng, thật tuyệt vời

Dữ liệu đi vào API dựa trên Google Trang tính. Nguồn tờ ở đây

Hợp lý. Tôi đã làm logic cho ứng dụng trong Trang tính. Trong trường hợp này, logic là “lấy cho tôi một ý tưởng kinh doanh ngẫu nhiên và cập nhật bộ đếm mỗi khi ai đó yêu cầu)

Tôi đã viết một công thức để chọn ba cột và chia nó thành hai ô (một ô là “X cho Y”, ô còn lại là “X cho Y bằng cách sử dụng Z”). Việc viết mã và gỡ lỗi hầu hết mọi thứ trong Trang tính dễ dàng hơn nhiều so với viết mã JavaScript, trừ khi bạn là một thuật sĩ JavaScript toàn diện (trong trường hợp đó, tại sao bạn lại ở đây? Hãy tạo một máy chủ NodeJS. )

Một trong những tế bào

=INDEX(Data!$A:$A,RANDBETWEEN(1,COUNTA(Data!$A:$A)),1)&" for "&INDEX(Data!$B:$B,RANDBETWEEN(1,COUNTA(Data!$B:$B)),1)&" using "&INDEX(Data!$C:$C,RANDBETWEEN(1,COUNTA(Data!$C:$C)),1)

Xác định đầu vào và đầu ra

Mục tiêu của ứng dụng này là có được một ý tưởng khởi động ngẫu nhiên thuộc một trong hai loại, ngắn hoặc dài

Bạn phải biết kết quả đầu ra của mình để biết cách bạn sẽ cấu trúc dữ liệu và xây dựng ứng dụng của mình. Vì vậy, thật tốt khi nghĩ về điều này trước

Để đơn giản, nhưng để có đầu vào và đầu ra (với mục đích trình diễn), tôi đã xác định đầu vào và đầu ra như sau

đầu vào

{type: Int}

Tôi gửi nó là '1' hoặc '2' và tùy thuộc vào những gì tôi gửi, tôi trả lại một loại hình kinh doanh khác

Đối với “1”, tôi trả lại “X cho Y”. Đối với “2”, tôi trả về “X cho Y bằng Z”

đầu ra

Đối với đầu ra của loại doanh nghiệp, tôi cung cấp cả chuỗi ý tưởng kinh doanh mà nó tạo ra, cộng với bộ đếm, để hiển thị số lượng ứng dụng của tôi đã tạo (cho đến nay, hàng nghìn. Ồ, có bao nhiêu người đang nhấp vào đây?)

{counter: Int, biz: String}

OK, bây giờ bạn đã sẵn sàng viết mã API trong Google Apps Script

Thiết lập API trong Google Apps Script

Đây là một chút thú vị

Các ứng dụng web được viết bằng Google Apps Script cần có hai chức năng.

{type: Int}

3 và 

{type: Int}

4

Hàm 

{type: Int}

3 thường được dùng để "lấy" dữ liệu. Đó là những gì chúng tôi đang làm trong ứng dụng này

Hàm 

{type: Int}

4 thường được dùng để "đặt" dữ liệu. Ví dụ: gửi một mục nhập diễn đàn. Chúng tôi không làm điều đó trong ứng dụng này

Trong trường hợp này, tôi chỉ nhập mã vào hàm 

{type: Int}

1 và điều đó không sao cả. Đây là mã

function doGet(e) { // get parameter to understand what to return  
    var bizType = e.parameter.type;
    var bizRange = 'B2'; // default cell for biz idea  if (bizType === '2') {    bizRange = 'B3';  }   
    var sheet = SpreadsheetApp.getActiveSheet(); // update the counter  
    var counterCell = sheet.getRange('C2');
    var counterVal = counterCell.getValue();
    sheet.getRange('C2').setValue(counterVal + 1); // get the data  var biz = sheet.getRange(bizRange).getValue();    // return the content  
    var bizReturner = {
        'idea': biz,
        'counter': counterVal
    };
    var myJSON = JSON.stringify(bizReturner);
    return ContentService.createTextOutput(myJSON).setMimeType(ContentService.MimeType.JSON);
}

function doPost(e) {
    return true;
}

Hầu hết mã này không quan trọng, chỉ cần logic để làm cho ứng dụng web ngớ ngẩn hoạt động. Đây là những bit quan trọng

Mã quan trọng 1. Nhận các tham số trong ứng dụng Apps Script của bạn

Khi bạn nhấp vào Xuất bản → Triển khai dưới dạng ứng dụng web và xuất bản nó, bạn sẽ nhận được một URL. Lưu ý rằng mỗi khi thay đổi mã, bạn phải lưu mã đó và xuất bản lại mã đó với phiên bản dự án mới mỗi lần. Ngoài ra, hãy đảm bảo rằng bạn chỉ định 'Bất kỳ ai, kể cả ẩn danh' đều có thể truy cập ứng dụng

Sau đó, bạn có thể gửi tham số qua URL, tôi. e. nối thêm 

{type: Int}

2 vào cuối

https://script.google.com/macros/s/AKfycbwYDuosLVjMU2GTL7tvsOAfZyEwtyJPoQpvtKVjwcZCD2DGchI/exec?type=2

Mã quan trọng 2. Nhận thông số vào ứng dụng Google Apps Script

Đọc các thông số (trong trường hợp này chỉ là một, ____13)

________số 8

Ghi chú. Sử dụng 

{type: Int}

4, không có 's' (i. e. không phải 

{type: Int}

5). Nếu bạn có dạng số nhiều, thì cấu trúc sẽ hơi khác một chút  —  mỗi khóa có một mảng giá trị. Xem tại đây để biết thêm chi tiết

Mã quan trọng 3. Gửi JSON đầu ra

Khi bạn xây dựng đầu ra của mình, bạn phải định dạng nó thành một chuỗi và gửi lại đúng cách để người nhận nhận được nó dưới dạng JSON

Dù bạn tạo đối tượng nào, trước tiên bạn phải biến nó thành một chuỗi, sau đó bạn phải gửi nó dưới dạng kiểu kịch câm JSON. Như thế này

{type: Int}

1

Và bạn có nó rồi đấy. Thử nó. Nó hơi chậm (thời gian phản hồi khoảng 2 giây) nhưng nó hoạt động

Sử dụng Google Apps Script và Google Sheets API mới của bạn

Về cơ bản, bạn có thể sử dụng API của mình ở bất kỳ đâu mà bạn có thể kết nối với API RESTful

Ứng dụng của bạn chỉ nằm đó trên đám mây, sẵn sàng để được gọi

Điều này có nghĩa là bạn có thể tạo, sử dụng Google Apps Script mới và API dựa trên Google Trang tính

• Một trang web có nút, khi bạn nhấn nút, nó sẽ gọi API và hiển thị thông tin
• Một ứng dụng hoạt động theo cùng một cách
• Email tự động sử dụng Zapier gửi ý tưởng kinh doanh mới mỗi ngày

Sự lựa chọn là của bạn về cách sử dụng API mới của bạn. Cách bạn thiết lập Google Trang tính và Google Apps Script rất giống nhau (nếu không muốn nói là giống hệt nhau) trong từng tình huống

Tôi có thể sử dụng Google Trang tính làm API không?

Google Apps Script có phải là API không?