Khi người dùng chọn một tệp và nhấp vào mục "Mở bằng" trong giao diện người dùng của Drive, Drive sẽ chuyển hướng người dùng đến URL mở của ứng dụng đó được xác định trong phần Định cấu hình chế độ tích hợp giao diện người dùng của Drive.
Nếu bạn đánh dấu vào hộp "Nhập" khi định cấu hình một chế độ tích hợp giao diện người dùng Drive, thì người dùng có thể chọn một tổ hợp các tệp dành riêng cho ứng dụng và các tệp trên Google Workspace để mở. Khi bạn định cấu hình chế độ tích hợp giao diện người dùng Drive, các tệp dành riêng cho ứng dụng sẽ được xác định trong các trường "Loại MIME mặc định" và "Phần mở rộng tệp mặc định", trong khi các tệp Google Workspace sẽ được xác định trong các trường "Loại MIME phụ" và "Phần mở rộng tệp phụ".
Đối với mỗi tệp mà người dùng muốn mở, Drive sẽ kiểm tra các loại MIME dựa trên loại MIME mặc định và loại MIME phụ mà bạn đã xác định:
Đối với các loại MIME được xác định trong trường "Loại MIME mặc định", mã nhận dạng tệp sẽ được truyền đến ứng dụng của bạn. Để biết thông tin về cách xử lý các tệp dành riêng cho ứng dụng, hãy xem phần Xử lý URL mở cho các tài liệu dành riêng cho ứng dụng.
Đối với các loại MIME được xác định trong trường "Loại MIME phụ", giao diện người dùng Drive sẽ hiển thị một hộp thoại hỏi người dùng loại tệp cần chuyển đổi tệp Google Workspace. Ví dụ: nếu bạn chọn một tệp Google Tài liệu trong giao diện người dùng Drive và trường "Loại MIME phụ" cho biết ứng dụng của bạn hỗ trợ text/plain hoặc application/pdf, thì giao diện người dùng Drive sẽ hỏi người dùng xem họ có muốn chuyển đổi sang Văn bản thuần tuý hoặc PDF hay không.
Để biết thông tin về cách xử lý các tệp Google Workspace, hãy xem phần Xử lý URL mở cho tài liệu Google Workspace. Để xem danh sách các định dạng chuyển đổi loại MIME và tài liệu trên Google Workspace, hãy xem bài viết Xuất các loại MIME cho tài liệu trên Google Workspace.
Xử lý URL mở cho các tài liệu dành riêng cho ứng dụng
Như đã đề cập trong phần Định cấu hình chế độ tích hợp giao diện người dùng Drive, ứng dụng của bạn sẽ nhận được các biến mẫu có thông tin để ứng dụng mở tệp. Ứng dụng của bạn nhận được một bộ biến mẫu mặc định trong tham số state
. Thông tin state
mặc định cho một URL mở dành riêng cho ứng dụng là:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
Kết quả này bao gồm các giá trị sau:
- ID: Mã nhận dạng của thư mục mẹ.
- RESOURCE_KEYS: Từ điển JSON gồm các mã nhận dạng tệp được liên kết với khoá tài nguyên tương ứng.
open
: Thao tác đang được thực hiện. Giá trị làopen
khi sử dụng một URL mở.- USER_ID: Mã nhận dạng hồ sơ giúp xác định người dùng một cách duy nhất.
Ứng dụng của bạn phải xử lý yêu cầu này bằng cách làm theo các bước sau:
- Xác minh rằng trường
action
có giá trị làopen
và trườngids
xuất hiện. - Sử dụng giá trị
userId
để tạo một phiên mới cho người dùng. Để biết thêm thông tin về người dùng đã đăng nhập, hãy xem bài viết Người dùng và sự kiện mới. - Sử dụng phương thức
files.get
để 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 bằng các giá trịID
. - Nếu
resourceKeys
được đặt trên yêu cầu, hãy đặt tiêu đề yêu cầuX-Goog-Drive-Resource-Keys
. Để biết thêm thông tin về khoá tài nguyên, hãy xem bài viết Truy cập vào các tệp được chia sẻ qua đường liên kết bằng khoá tài nguyên.
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.
Xử lý URL mở cho tài liệu trên Google Workspace
Như đã đề cập trong phần Định cấu hình chế độ tích hợp giao diện người dùng Drive, ứng dụng của bạn sẽ nhận được một nhóm biến mẫu mặc định trong tham số state
. Thông tin state
mặc định cho một URL mở của Google Workspace là:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
Kết quả này bao gồm các giá trị sau:
- EXPORT_ID: Danh sách mã nhận dạng tệp được xuất, phân tách bằng dấu phẩy (chỉ dùng khi mở tài liệu tích hợp của Google).
- RESOURCE_KEYS: Từ điển JSON gồm các mã nhận dạng tệp được liên kết với khoá tài nguyên tương ứng.
open
: Thao tác đang được thực hiện. Giá trị làopen
khi sử dụng một URL mở.- USER_ID: Mã hồ sơ dùng để xác định người dùng.
Ứng dụng của bạn phải xử lý yêu cầu này bằng cách làm theo các bước sau:
Xác minh rằng đây là yêu cầu mở một tệp bằng cách phát hiện cả giá trị
open
trong trườngstate
và sự hiện diện của trườngexportIds
.Sử dụng phương thức
files.get
để kiểm tra quyền, tìm nạp siêu dữ liệu tệp và xác định loại MIME bằng cách sử dụng các giá trịEXPORT_ID
.Chuyển đổi nội dung tệp bằng phương thức
files.export
. Mã mẫu sau đây cho biết cách xuất một tài liệu trên Google Workspace sang loại MIME được yêu cầu.Nếu
resourceKey
được đặt trên yêu cầu, hãy đặt tiêu đề yêu cầuX-Goog-Drive-Resource-Keys
. Để biết thêm thông tin về khoá tài nguyên, hãy xem bài viết Truy cập vào các tệp được chia sẻ qua đường liên kết bằng khoá tài nguyên.Java
Python
Node.js
PHP
Hiển thị các tệp đã chuyển đổi ở chế độ chỉ đọc hoặc hiển thị một hộp thoại cho phép người dùng lưu tệp dưới dạng loại tệp 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.
Người dùng và sự kiện mới
Các ứng dụng Drive nên coi tất cả sự kiện "mở bằng" là các lượt đăng nhập tiềm năng. Một số người dùng có thể có nhiều tài khoản, nên mã nhận dạng người dùng trong tham số state
có thể không khớp với phiên hiện tại. Nếu mã nhận dạng người dùng trong tham số state
không khớp với phiên hiện tại, hãy kết thúc phiên hiện tại cho ứng dụng của bạn và đăng nhập với tư cách là người dùng được yêu cầu.
Chủ đề có liên quan
Ngoài việc mở một ứng dụng từ giao diện người dùng Google Drive, các ứng dụng có thể hiển thị một trình chọn tệp để chọn nội dung trong một ứng dụng. Để biết thêm thông tin, hãy xem Google Picker.