Tài nguyên: Tài sản
Cặp khoá-giá trị được đính kèm vào 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 thuộc tính tệp:
- Mỗi tệp chỉ được chứa tối đa 100 thuộc tính
- Mỗi ứng dụng chỉ được có tối đa 30 tài sản riêng tư
- 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ị) theo phương thức 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 } |
Trường | |
---|---|
selfLink |
Chỉ có đầu ra. Đường liên kết quay lại tài sản 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 TƯ (mặc định) và CÔNG KHAI. Bạn chỉ có thể truy xuất tài sản riêng tư bằng cách sử dụng yêu cầu đã được xác thực. Yêu cầu đã xác thực sẽ dùng một mã truy cập có được 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 thuộc tính riêng tư. |
kind |
Chỉ có đầu ra. Thao tác này luôn là |
etag |
Chỉ có đầu ra. ETag của cơ sở lưu trú. |
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á. |
|
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. |
|
Liệt kê các thuộc tính của một tệp. |
|
Cập nhật tài sản. |
|
Cập nhật tài sản. |