Hướng dẫn so sánh API Drive phiên bản 2 và phiên bản 3

Phiên bản API Google Drive mới nhất là phiên bản 3. Hiệu suất trong phiên bản 3 tốt hơn vì các lượt tìm kiếm chỉ trả về một tập hợp con các trường. Hãy sử dụng phiên bản hiện tại trừ phi bạn cần bộ sưu tập v2. Nếu bạn đang sử dụng phiên bản 2, hãy cân nhắc việc chuyển sang phiên bản 3. Để di chuyển, hãy xem phần Di chuyển sang API Drive phiên bản 3. Để biết danh sách đầy đủ các điểm khác biệt về phiên bản, hãy xem Tài liệu tham khảo để so sánh API Drive phiên bản 2 và v3.

Nếu bạn muốn tiếp tục sử dụng phiên bản 2, hãy xem bản sửa đổi Hướng dẫn sử dụng API Drive phiên bản 2 để tìm hiểu cách sửa đổi một số nội dung trong hướng dẫn v3 cho nhà phát triển phiên bản 2.

Để tìm hiểu thêm về các điểm cải tiến cho API Drive phiên bản 3, bạn có thể xem video sau đây của các kỹ sư Google thảo luận về thiết kế API mới.

Các điểm cải tiến của phiên bản 3

Để tối ưu hoá hiệu suất và giảm độ phức tạp của hành vi API, phiên bản 3 mang đến những điểm cải tiến sau so với phiên bản API trước đó:

• Theo mặc định, các lượt tìm kiếm tệp và bộ nhớ dùng chung không trả về toàn bộ tài nguyên mà chỉ trả về một nhóm nhỏ các trường thường dùng. Để biết thêm thông tin về fields, hãy xem phương thức files.list và phương thức drives.list.
• Hiện tại, hầu hết các phương thức trả về một phản hồi đều yêu cầu tham số fields. Để biết danh sách tất cả các phương thức yêu cầu fields, hãy xem Tài liệu tham khảo API Drive.
• Những tài nguyên có chức năng trùng lặp đã bị xoá. Một số ví dụ:
  • Phương thức files.list thực hiện chức năng giống như các bộ sưu tập Children và Parents, nên chúng sẽ bị xoá khỏi phiên bản 3.
  • Đã xoá các phương thức Realtime.*.
• Theo mặc định, Dữ liệu ứng dụng không được trả về trong các lượt tìm kiếm. Trong phiên bản 2, bạn có thể đặt phạm vi drive.appdata và phương thức này trả về dữ liệu ứng dụng từ phương thức files.list và phương thức changes.list, nhưng phương thức này sẽ làm chậm hiệu suất. Trong phiên bản 3, bạn sẽ đặt phạm vi drive.appdata, đồng thời đặt tham số truy vấn spaces=appDataFolder để yêu cầu dữ liệu ứng dụng.
• Tất cả các thao tác cập nhật đều sử dụng PATCH thay vì PUT.
• Để xuất tệp Google Tài liệu, hãy sử dụng phương thức files.export.
• Hành vi của phương thức changes.list sẽ khác. Thay vì dùng mã thay đổi, hãy sử dụng mã thông báo trang mờ. Để thăm dò tập hợp thay đổi, trước tiên, hãy gọi phương thức changes.getStartPageToken cho giá trị ban đầu. Đối với các truy vấn tiếp theo, phương thức changes.list sẽ trả về giá trị newStartPageToken.
• Hiện tại, phương thức cập nhật sẽ từ chối các yêu cầu chỉ định các trường không thể ghi.
• Các trường exportFormats và importFormats v2 trong tài nguyên about là danh sách các định dạng nhập hoặc xuất được phép. Trong phiên bản 3, chúng là bản đồ loại MIME của các mục tiêu có thể xảy ra cho tất cả các mục nhập hoặc xuất được hỗ trợ.
• Bí danh v2 appdata và appfolder hiện đã có appDataFolder trong v3.
• Tài nguyên properties đã bị xoá khỏi phiên bản 3. Tài nguyên files có trường properties chứa các cặp khoá-giá trị thực. Trường properties chứa các thuộc tính công khai, còn trường appProperties chứa các thuộc tính riêng tư, nên bạn không cần dùng trường chế độ hiển thị.
• Trường modifiedTime trong tài nguyên files sẽ cập nhật vào lần gần đây nhất có ai sửa đổi tệp đó. Trong phiên bản 2, trường modifiedDate chỉ có thể thay đổi khi cập nhật nếu bạn đặt trường setModifiedDate.
• Trường viewedByMeTime trong tài nguyên files không tự động cập nhật.
• Để nhập các định dạng Google Tài liệu, bạn cần đặt mimeType mục tiêu thích hợp trong phần nội dung tài nguyên. Trong phiên bản 2, bạn đã đặt ?convert=true.
• Thao tác nhập sẽ trả về lỗi 400 nếu định dạng không được hỗ trợ.
• Người đọc và người nhận xét không thể xem các quyền.
• Bí danh me cho các quyền đã bị xoá.
• Một số chức năng có sẵn như một phần của tài nguyên yêu cầu nhưng thay vào đó lại có sẵn dưới dạng tham số yêu cầu. Ví dụ:
  • Trong phiên bản 2, bạn có thể dùng children.delete để xoá tệp con khỏi thư mục mẹ.
  • Trong phiên bản 3, bạn sử dụng files.update trên thành phần con với ?removeParents=parent_id trong URL.

Điểm khác biệt khác

Tên trường và thông số khác nhau trong phiên bản 3. Một số ví dụ bao gồm:

• Thuộc tính name thay thế title trong tài nguyên files.
• Time là hậu tố cho tất cả các trường ngày và giờ thay vì Date.
• Thao tác danh sách không sử dụng trường items để chứa nhóm kết quả. Loại tài nguyên cung cấp một trường cho kết quả (chẳng hạn như files hoặc changes).