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 "Mới" trong giao diện người dùng Drive rồi chọn một ứng dụng trong Giao diện người dùng Drive, Drive chuyển hướng người dùng đến URL mới của ứng dụng đó xác định trong phần Định cấu hình giao diện người dùng Drive tích hợp.

Sau đó, ứng dụng của bạn sẽ nhận được một tập hợp các biến mẫu mặc định trong một Tham số state. state mặc định cho một URL mới là:

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

Kết quả này bao gồm các giá trị sau:

  • create: Hành động đang được thực hiện. Giá trị là create khi người dùng nhấp vào "Mới" của Giao diện người dùng Drive nút.
  • 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ã hồ sơ xác định duy nhất người dùng.

Ứng dụng của bạn phải hành động theo 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ị 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 phần 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 bạn đặt folderId cho yêu cầu, hãy đặt giá trị trường parents sang giá trị folderId.
  4. Nếu bạn đặt folderResourceKey cho yêu cầu, hãy đặt giá trị 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, xem phần Truy cập vào tệp được chia sẻ liên kết bằng tài nguyên khoá.

Tham số state được mã hoá URL, vì vậy ứng dụng của bạn phải xử lý ký tự thoát và phân tích cú pháp tệp đó dưới dạng JSON.

Người dùng và sự kiện mới

Các ứng dụng Drive sẽ xử lý tất cả các lệnh "tạo" các sự kiện dưới dạng tiềm năng đăng nhập. Một số người dùng có thể có nhiều tài khoản, vì vậy, mã nhận dạng người dùng trong 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 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 và đăng nhập bằng tên người dùng được yêu cầu.