Tài nguyên: Thuộc tính
Một cặp khoá-giá trị được đính kèm vào một tệp công khai hoặc riêng tư đối với một ứng dụng.
Các giới hạn sau đây áp dụng cho thuộc tính tệp:
- Tối đa 100 thuộc tính cho 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 124 byte đối với chuỗi (khoá + giá trị) được mã hoá theo 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 } |
Trường | |
---|---|
selfLink |
Chỉ có đầu ra. Đường liên kết quay lại cơ sở lưu trú này. |
value |
Giá trị của thuộc tính này. |
visibility |
Chế độ hiển thị của thuộc tính này. Các giá trị được phép là RIÊNG (mặc định) và CÔNG KHAI. Bạn chỉ có thể truy xuất tài sản riêng tư bằng một yêu cầu đã được xác thực. Yêu cầu đã xác thực sử dụng mã truy cập được lấy bằng mã ứng dụng khách OAuth 2. Bạn không thể sử dụng khoá API để truy xuất các tài sản riêng tư. |
kind |
Chỉ có đầu ra. Giá trị này luôn là |
etag |
Chỉ có đầu ra. ETag của tài sản. |
key |
Khoá của thuộc tính này. |
Phương thức |
|
---|---|
|
Xoá một tài sản. |
|
Lấy một thuộc tính theo khoá của thuộc tính đó. |
|
Thêm một thuộc tính vào tệp hoặc cập nhật thuộc tính đó nếu thuộc tính đó đã tồn tại. |
|
Liệt kê các thuộc tính của tệp. |
|
Cập nhật một cơ sở lưu trú. |
|
Cập nhật một cơ sở lưu trú. |