Để hiển thị ứng dụng của bạn trong Google Drive khi người dùng tạo hoặc mở tệp, trước tiên, bạn phải thiết lập tính năng tích hợp giao diện người dùng (UI) của Drive. Bạn cũng cần phải định cấu hình để đăng ứng dụng của mình lên Google Workspace Marketplace.
Bật API Drive
Trước khi sử dụng API của Google, bạn phải bật các API đó trong một dự án trên Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án trên Google Cloud.
Để bắt đầu tích hợp với giao diện người dùng của Google Drive, bạn phải bật API Drive. Nhờ đó, bạn có thể sử dụng API và các tính năng tích hợp giao diện người dùng.
Trong Cloud Console, hãy bật API Google Drive.
Thiết lập chế độ tích hợp giao diện người dùng Drive
- Trong Google API Console, hãy chuyển đến biểu tượng Trình đơn > API và dịch vụ > API và dịch vụ đã bật.
- Ở cuối trang tổng quan API và Dịch vụ, hãy nhấp vào API Google Drive. Trang cấu hình API Google Drive sẽ xuất hiện.
- Chọn thẻ Tích hợp giao diện người dùng Drive.
- (Không bắt buộc) Nhập tên vào trường Tên ứng dụng. Tên ứng dụng sẽ xuất hiện cho người dùng trong thẻ Quản lý ứng dụng trong phần cài đặt Drive.
- (Không bắt buộc) Nhập một đoạn mô tả ngắn dài một dòng vào trường Mô tả ngắn. Nội dung mô tả ngắn sẽ xuất hiện cho người dùng trong thẻ Quản lý ứng dụng trong phần cài đặt Drive.
- (Không bắt buộc) Nhập nội dung mô tả đầy đủ vào trường Nội dung mô tả dài.
Tải một hoặc nhiều Biểu tượng ứng dụng lên để hiển thị trong danh sách các ứng dụng Drive đã kết nối của người dùng và trong trình đơn theo bối cảnh "Mở bằng". Biểu tượng phải ở định dạng PNG có nền trong suốt. Có thể mất đến 24 giờ thì biểu tượng mới xuất hiện trong Drive.
Để sử dụng mục "Mở bằng" trong trình đơn của giao diện người dùng Drive, hãy nhập URL vào ứng dụng của bạn trong trường Mở URL. URL này được trình đơn theo bối cảnh "Mở bằng" sử dụng.
- URL này phải chứa tên miền đủ điều kiện;
localhostkhông hoạt động. - Người dùng dự kiến của ứng dụng phải truy cập được vào URL này. Nếu bạn có nhiều phiên bản ứng dụng, chẳng hạn như một phiên bản phát hành công khai và một phiên bản phát hành có giới hạn cho một số người dùng, thì mỗi phiên bản phải sử dụng một URL riêng biệt. Sau đó, bạn có thể tạo các cấu hình ứng dụng khác nhau cho từng phiên bản.
- Bạn phải xác minh quyền sở hữu URL này thì mới có thể đăng ứng dụng của mình lên Google Workspace Marketplace.
- Theo mặc định, tham số truy vấn
stateđược thêm vào URL này để truyền dữ liệu từ giao diện người dùng Drive đến ứng dụng của bạn. Để biết thông tin về nội dung của tham sốstate, hãy xem phần Tham sốstate.
- URL này phải chứa tên miền đủ điều kiện;
(Không bắt buộc) Nhập loại MIME và đuôi tệp mặc định vào các trường Loại MIME mặc định và Đuôi tệp mặc định. Loại MIME và đuôi tệp mặc định đại diện cho các tệp mà ứng dụng của bạn được thiết kế riêng để mở. Ví dụ: ứng dụng của bạn có thể mở một định dạng tích hợp sẵn để phân lớp và chỉnh sửa hình ảnh. Chỉ thêm loại nội dung nghe nhìn chuẩn và đảm bảo không có lỗi chính tả. Nếu ứng dụng của bạn chỉ mở tệp lối tắt hoặc tệp lối tắt của bên thứ ba, bạn có thể để trống loại MIME.
(Không bắt buộc) Nhập loại MIME phụ và đuôi tệp phụ vào các trường Loại MIME phụ và Đuôi tệp phụ. Loại MIME phụ và đuôi tệp đại diện cho các tệp mà ứng dụng của bạn có thể mở, nhưng không dành riêng cho ứng dụng của bạn. Ví dụ: ứng dụng của bạn có thể là một ứng dụng chỉnh sửa hình ảnh mở hình ảnh PNG và JPG. Chỉ thêm loại nội dung nghe nhìn chuẩn và đảm bảo không có lỗi chính tả. Nếu ứng dụng của bạn chỉ mở tệp lối tắt hoặc tệp lối tắt của bên thứ ba, bạn có thể để trống loại MIME.
Để sử dụng nút "Mới" trên giao diện người dùng của Drive và cho phép người dùng tạo tệp bằng ứng dụng của bạn, hãy đánh dấu vào hộp Tạo tệp. Các trường URL mới và Tên tài liệu (không bắt buộc) sẽ xuất hiện.
- URL này phải chứa tên miền đủ điều kiện;
localhostkhông hoạt động. - Bạn phải xác minh quyền sở hữu URL này thì mới có thể đăng ứng dụng của mình lên Google Workspace Marketplace.
- Theo mặc định, tham số truy vấn
stateđược thêm vào URL này để truyền dữ liệu từ giao diện người dùng Drive đến ứng dụng của bạn. Để biết thông tin về nội dung của tham sốstate, hãy xem phần Tham sốstate.
- URL này phải chứa tên miền đủ điều kiện;
Nhập một URL vào trường URL mới. Nút "Mới" sử dụng URL này để chuyển hướng người dùng đến ứng dụng của bạn.
(Không bắt buộc) Nếu bạn muốn ứng dụng của mình mở các tệp được Google Workspace hỗ trợ, hãy đánh dấu vào hộp Nhập.
(Không bắt buộc) Nếu ứng dụng của bạn phải quản lý tệp trên bộ nhớ dùng chung, hãy đánh dấu vào hộp Hỗ trợ bộ nhớ dùng chung. Để biết thêm thông tin về cách hỗ trợ bộ nhớ dùng chung trong ứng dụng, hãy xem phần Triển khai tính năng hỗ trợ bộ nhớ dùng chung.
Nhấp vào Gửi.
Yêu cầu phạm vi drive.install
Để cho phép ứng dụng xuất hiện dưới dạng một lựa chọn trong trình đơn "Mở bằng" hoặc "Mới", hãy yêu cầu phạm vi https://www.googleapis.com/auth/drive.install để tích hợp với giao diện người dùng Drive. Khi yêu cầu phạm vi này, người dùng sẽ nhận được một hộp thoại tương tự như sau:
Để biết thêm thông tin về các phạm vi mà bạn có thể yêu cầu cho ứng dụng Drive và cách yêu cầu các phạm vi đó, hãy xem phần Thông tin xác thực và uỷ quyền theo API cụ thể.
Tham số state
Theo mặc định, tham số state được thêm vào cả URL mở và URL mới để truyền dữ liệu từ giao diện người dùng Drive đến ứng dụng của bạn. Tham số này chứa một chuỗi được mã hoá JSON với các biến mẫu và dữ liệu về yêu cầu đến ứng dụng của bạn. Các biến được đưa vào phụ thuộc vào loại URL được sử dụng (URL mở hoặc URL mới):
| Biến mẫu | Mô tả | URL ứng dụng |
|---|---|---|
{ids} |
Danh sách mã tệp được phân tách bằng dấu phẩy đang được mở. | Mở URL |
{exportIds} |
Danh sách mã tệp được phân tách bằng dấu phẩy đang được xuất. Chỉ dùng khi mở tệp trên Google Workspace. | Mở URL |
{resourceKeys} |
Từ điển JSON gồm các mã tệp được liên kết với khoá tài nguyên tương ứng. | Mở URL |
{folderId} |
Mã của thư mục mẹ. | URL mới |
{folderResourceKey} |
Khoá tài nguyên của thư mục mẹ. | URL mới |
{userId} |
Mã hồ sơ giúp xác định người dùng. | URL mở và URL mới |
{action} |
Hành động đang được thực hiện. Giá trị là open khi sử dụng URL mở hoặc create khi sử dụng URL mới.
|
URL mở và URL mới |
Tham số state được mã hoá URL, vì vậy, ứng dụng của bạn phải xử lý các ký tự thoát và phân tích cú pháp dưới dạng JSON. Ứng dụng có thể phát hiện giá trị create trong tham số state để xác minh yêu cầu tạo tệp.
Ví dụ về thông tin trạng thái ở định dạng JSON cho một URL mới
Thông tin state cho một URL mới là:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
Ví dụ về thông tin trạng thái ở định dạng JSON cho một URL mở
Thông tin state cho một URL mở là:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
Mã nhận dạng và khoá tài nguyên được dùng để tìm nạp siêu dữ liệu tệp và tải nội dung tệp xuống. Sau khi có mã nhận dạng tệp và mã truy cập, ứng dụng có thể kiểm tra quyền, tìm nạp siêu dữ liệu của tệp và tải nội dung tệp xuống như mô tả trong phương thức files.get.
Chủ đề có liên quan
Ứng dụng cần cài đặt phải có thể tạo, quản lý và mở các hành động được khởi chạy từ giao diện người dùng Drive. Để tìm hiểu thêm, hãy xem bài viết Tích hợp với nút "Mới" trên giao diện người dùng của Drive hoặc Tích hợp với trình đơn theo bối cảnh "Mở bằng" trên giao diện người dùng của Drive.