Định cấu hình tính năng tích hợp giao diện người dùng trong Drive

Để hiển thị ứng dụng của bạn trong Google Drive khi người dùng tạo hoặc mở một tệp, trước tiên, bạn phải thiết lập chế độ tích hợp giao diện người dùng (UI) của Drive. Bạn cũng phải định cấu hình để đưa ứng dụng của mình vào Google Workspace Marketplace.

Bật Drive API

Trước khi sử dụng các API của Google, bạn phải bật các API đó trong một dự án Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án Google Cloud.

Để bắt đầu tích hợp với giao diện người dùng Google Drive, bạn phải bật Drive API. Thao tác này cho phép bạn truy cập vào API và các tính năng tích hợp giao diện người dùng.

  • Trong Google Cloud Console, hãy bật Google Drive API.

    Bật API

Thiết lập chế độ tích hợp giao diện người dùng Drive

  1. Trong Google API Console, hãy chuyển đến phần Trình đơn > API và Dịch vụ > API và dịch vụ đã bật.

    Chuyển đến phần API và dịch vụ đã bật

  2. Ở cuối trang tổng quan về API và Dịch vụ, hãy nhấp vào Google Drive API. Trang cấu hình API Google Drive sẽ xuất hiện.
  3. Chọn thẻ Tích hợp giao diện người dùng Drive.
  4. (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 với người dùng trong thẻ Quản lý ứng dụng trong phần cài đặt Drive.
  5. (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. Người dùng sẽ thấy nội dung mô tả ngắn trong thẻ Quản lý ứng dụng trong phần cài đặt Drive.
  6. (Không bắt buộc) Nhập nội dung mô tả đầy đủ trong trường Nội dung mô tả dài.
  7. 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 được 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 và có nền trong suốt. Biểu tượng có thể mất đến 24 giờ mới xuất hiện trong Drive.

  8. Để sử dụng mục "Mở bằng" trong giao diện người dùng của Drive, hãy nhập URL đến ứng dụng của bạn vào 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 một tên miền đủ điều kiện; localhost khô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 hạn chế 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 trước khi có thể đăng ứng dụng của mình trong Google Workspace Marketplace.
    • Theo mặc định, tham số truy vấn state sẽ đượ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.
  9. (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Đuôi tệp mặc định. Các loại MIME và đuôi tệp mặc định đại diện cho những tệp mà ứng dụng của bạn được tạo riêng để mở. Ví dụ: ứng dụng của bạn có thể mở một định dạng tích hợp để xếp lớp và chỉnh sửa hình ảnh. Chỉ thêm các loại nội dung nghe nhìn tiêu chuẩn và đảm bảo rằng các loại này không có lỗi chính tả. Nếu ứng dụng của bạn chỉ mở tệp phím tắt hoặc tệp phím tắt của bên thứ ba, bạn có thể để trống loại MIME.

  10. (Không bắt buộc) Nhập các loại MIME và đuôi tệp phụ vào các trường Loại MIME phụĐuôi tệp phụ. Loại MIME và đuôi tệp phụ đại diện cho những 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 có thể mở hình ảnh PNG và JPG. Chỉ thêm các loại nội dung nghe nhìn tiêu chuẩn và đảm bảo rằng các loại này không có lỗi chính tả. Nếu ứng dụng của bạn chỉ mở tệp phím tắt hoặc tệp phím tắt của bên thứ ba, bạn có thể để trống loại MIME.

  11. Để sử dụng nút "Mới" của giao diện người dùng 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ớiTên tài liệu (không bắt buộc) sẽ xuất hiện.

    • URL này phải chứa một tên miền đủ điều kiện; localhost không hoạt động.
    • Bạn phải xác minh quyền sở hữu URL này trước khi có thể đăng ứng dụng của mình trong Google Workspace Marketplace.
    • Theo mặc định, tham số truy vấn state sẽ đượ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.
  12. Nhập một URL vào trường URL mới. URL này được nút "Mới" dùng để chuyển hướng người dùng đến ứng dụng của bạn.

  13. (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.

  14. (Không bắt buộc) Nếu ứng dụng của bạn phải quản lý các 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.

  15. Nhấp vào Gửi.

Yêu cầu phạm vi drive.install

Để cho phép các ứ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:

Hộp thoại cài đặt của giao diện người dùng Google Drive.
Hình 1. Hộp thoại cài đặt khi sử dụng các phạm vi cho giao diện người dùng Drive.

Để 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 Thông tin uỷ quyền và xác thực dành riêng cho API.

Tham số state

Theo mặc định, một tham số state sẽ đượ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 đối với ứ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ả Ứng dụng URL
{ids} Danh sách mã nhận dạng tệp được phân tách bằng dấu phẩy đang được mở. Mở URL
{exportIds} Danh sách mã nhận dạng tệp được phân tách bằng dấu phẩy sẽ được xuất (chỉ dùng khi mở tài liệu Google tích hợp). Mở URL
{resourceKeys} Một từ điển JSON gồm các mã tệp được liên kết với các 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ã nhận dạng hồ sơ xác định người dùng. Mở URL 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. Mở URL và URL mới

Tham số state được mã hoá bằng 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 tham số này dưới dạng JSON. Các ứ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ủa bạn có thể kiểm tra quyền, tìm nạp siêu dữ liệu tệp và tải nội dung tệp xuống như mô tả trong phương thức files.get.

Ứng dụng đã cài đặt phải có thể tạo, quản lý và mở các thao tác đượ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" của giao diện người dùng Drive hoặc Tích hợp với trình đơn theo bối cảnh "Mở bằng" của giao diện người dùng Drive.