Phần 2: Permissions & Scopes và thêm ứng dụng vào Lark

Ở phần 1, mình đã hướng dẫn các bạn tạo và release một Custom App để sử dụng Lark API, các bạn có thể xem lại tại đây

Trong bài viết này, mình sẽ hướng dẫn cách thêm quyền (Permissions & Scopes) cho ứng dụng và add Ứng dụng vào file (mình sẽ lấy ví dụ là Lark Base) để có thể chỉnh sửa được file đó

---

Trước tiên hãy cùng tìm hiểu, Permissions & Scopes là gì? Bạn có thể hiểu đơn giản đây là giới hạn mà ứng dụng của bạn có thể truy cập vào dữ liệu trên Lark. Ví dụ, bạn chỉ cấp quyền cho ứng dụng thao tác với file Base, thì nó sẽ không chạy được trên các file Docs và Sheets

Để có thể thêm Permissions & Scopes cho ứng dụng, trước tiên bạn phải truy cập trang Lark Developer tại https://open.larksuite.com/app, sau đó chọn ứng dụng mà bạn đã tạo và chọn mục Permissions & Scopes


Sau đó, bạn hãy tìm mục API Scopes và tìm mục Manage scopes, tại đây bạn sẽ thấy Lark cung cấp cho bạn rất nhiều quyền thao tác, ví dụ như với Contacts, Messenger, Calendar,...


Để biết chính xác mình cần sử dụng Sopes nào, bạn hãy truy cập trang tài liệu về API của Lark tại đây
Ví dụ, mình muốn sử dụng ứng dụng để thực hiện việc đọc, ghi, cập nhật và xóa trên Lark Base, mình sẽ tìm đến mục Docs, chọn Base và chọn vào phần record (Lưu ý: Trong khuôn khổ bài viết và Series về Lark và Chatbot này, mình sẽ làm chủ yếu về API với Lark Base, các bạn có thể tư duy và phát triển cách sử dụng API với các phần khác nhé)


Trong mục record này, bạn sẽ lại thấy nhiều mục khác như:
- Record filter development guide: lấy giá trị record theo một bộ lọc, ví dụ: bộ lọc danh sách các khách hàng có số điện thoại là 0987654321
- Get records: lấy thông tin bản record
- List record: lấy tất cả record trên Base
- Create a record: tạo một record mới
- Update a record: cập nhật (sửa) một record hiện tại
- Delete a record: xóa một record

Khi chọn một mục, bạn sẽ nhìn thấy các thông tin về API như:
- URL: https://open.larksuite.com/open-apis/bitable/v1/apps/:app_token/tables/:table_id/records/:record_id
- Method: GET
- Rate Limit: 20 per second (số lần gọi API/giây)
- Supported app types: các loại ứng dụng hỗ trợ sử dụng API
- Required scopes: đây chính là Scopes mà bạn cần xin quyền cho ứng dụng của mình để thao tác với Base (ví dụ với API Get records yêu cầu 2 scopes là View, comment, edit and manage Base và View, comment, and export Base)
Và nhiều thông tin khác, mình sẽ chia sẻ ở các bài viết sau nhé, trong phạm vi bài viết này bạn chỉ cần nắm được mình cần scopes gì để gọi API thôi



Sau khi đã có được tên scopes, bạn quay lại trang Manage scopes, tìm tên và tích chọn các scopes đó và chọn Add in bulk nhé


Sau khi thêm scopes, Lark sẽ yêu cầu bạn phải tạo một phiên bản cập nhật mới cho ứng dụng, các bạn hãy chọn Confirm and go to create app version


Sau đó bạn hãy điền các thông tin của Version như phần 1 mình đã hướng dẫn và chọn Release để admin doanh nghiệp duyệt nhé

Tiếp theo, bạn cần thêm ứng dụng trên vào một file Lark. Trên thanh công cụ chọn Menu, More và Add Applications nhé


Tại cửa sổ Applications, bạn hãy nhập tên ứng dụng đã tạo vào. Lưu ý nếu bạn không thực hiện thêm scope vào thì ứng dụng sẽ không hiển thị đâu nhé


Sau khi hiển thị ứng dụng, chọn ứng dụng và chọn Add


Vậy là bạn đã hoàn thành việc thêm ứng dụng vào file Lark Base để lấy quyền chỉnh sửa qua API rồi. Hẹn gặp lại bạn tại các bài viết sau