REST Resource: properties

Tài nguyên: Tài sản

Một cặp khoá-giá trị được đính kèm với một tệp ở chế độ công khai hoặc riêng tư đối với ứng dụng.

Các giới hạn sau áp dụng cho các thuộc tính tệp:

  • Bạn chỉ được có tổng cộng tối đa 100 tài sản trong mỗi tệp
  • Tối đa 30 tài sản riêng tư trên mỗi ứng dụng
  • Tối đa 30 tài sản công khai
  • Giới hạn kích thước tối đa là 124 byte trên chuỗi (khoá + giá trị) trong bộ mã hoá UTF-8 cho một thuộc tính

Một số phương thức tài nguyên (chẳng hạn như properties.update) yêu cầu propertyKey. Sử dụng phương thức properties.list để truy xuất khoá cho một thuộc tính.

Biểu diễn dưới dạng JSON
{
  "selfLink": string,
  "value": string,
  "visibility": string,
  "kind": string,
  "etag": string,
  "key": string
}
Các trường
value

string

Giá trị của thuộc tính này.

visibility

string

Chế độ hiển thị của tài sản này. Các giá trị được phép là PRIVATE (mặc định) và PUBLIC. Bạn chỉ có thể truy xuất tài sản riêng tư bằng yêu cầu đã được xác thực. Yêu cầu đã xác thực sẽ dùng mã truy cập thu được qua mã ứng dụng khách OAuth 2. Bạn không thể sử dụng khoá API để truy xuất các thuộc tính riêng tư.

kind

string

Chỉ có đầu ra. Giá trị này luôn là drive#property.

etag

string

Chỉ có đầu ra. ETag của cơ sở lưu trú.

key

string

Khoá của thuộc tính này.

Phương thức

delete

Xoá một tài sản.

get

Lấy một thuộc tính theo khoá của thuộc tính đó.

insert

Thêm thuộc tính vào tệp hoặc cập nhật thuộc tính nếu đã tồn tại.

list

Liệt kê các thuộc tính của tệp.

patch

Cập nhật một tài sản.

update

Cập nhật một tài sản.