Tích hợp với nút "Mới" của giao diện người dùng Drive

Khi người dùng nhấp vào nút "Mới" trên giao diện người dùng của Drive và chọn một ứng dụ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ới 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.

Sau đó, ứ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ới là:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

Đầu ra này bao gồm các giá trị sau:

  • create: Thao tác đang được thực hiện. Giá trị là create khi người dùng nhấp vào nút "Mới" của giao diện người dùng Drive.
  • FOLDER_ID: Mã của thư mục mẹ.
  • FOLDER_RESOURCE_KEY: Khoá tài nguyên của thư mục mẹ.
  • USER_ID: Mã nhận dạng hồ sơ 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:

  1. Xác minh rằng trường action có giá trị là create.
  2. 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.
  3. Sử dụng phương thức files.create để tạo một tài nguyên tệp. Nếu folderId được đặt trên yêu cầu, hãy đặt trường parents thành giá trị folderId.
  4. Nếu folderResourceKey được đặt trên yêu cầu, hãy đặt tiêu đề của yêu cầu X-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.

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 "tạo" là các lần đă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.