REST Resource: properties
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: Properti
Pasangan nilai kunci yang dilampirkan ke file yang bersifat publik atau pribadi untuk aplikasi.
Batas berikut berlaku untuk properti file:
- Maksimal 100 properti total per file
- Maksimum 30 properti pribadi per aplikasi
- Maksimum 30 properti publik
- Batas ukuran maksimum 124 byte pada string (kunci + nilai) dalam encoding UTF-8 untuk satu properti
Beberapa metode resource (seperti properties.update
) memerlukan propertyKey
. Gunakan metode properties.list
untuk mengambil kunci properti.
Representasi JSON |
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
Kolom |
selfLink |
string
Hanya output. Link kembali ke properti ini.
|
value |
string
Nilai properti ini.
|
visibility |
string
Visibilitas properti ini. Nilai yang diizinkan adalah PRIVATE (default) dan PUBLIC. Properti pribadi hanya dapat diambil menggunakan permintaan yang diautentikasi. Permintaan yang diautentikasi menggunakan token akses yang diperoleh dengan client ID OAuth 2. Anda tidak dapat menggunakan kunci API untuk mengambil properti pribadi.
|
kind |
string
Hanya output. Nilai ini selalu drive#property .
|
etag |
string
Hanya output. ETag properti.
|
key |
string
Kunci properti ini.
|
Metode |
|
Menghapus properti. |
|
Mendapatkan properti berdasarkan kuncinya. |
|
Menambahkan properti ke file, atau memperbaruinya jika sudah ada. |
|
Mencantumkan properti file. |
|
Memperbarui properti. |
|
Memperbarui properti. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[],[],null,["# REST Resource: properties\n\n- [Resource: Property](#Property)\n - [JSON representation](#Property.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Property\n------------------\n\nA key-value pair attached to a file that is either public or private to an application.\n\nThe following limits apply to file properties:\n\n- Maximum of 100 properties total per file\n- Maximum of 30 private properties per app\n- Maximum of 30 public properties\n- Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property\n\nSome resource methods (such as `properties.update`) require a `propertyKey`. Use the `properties.list` method to retrieve the key for a property.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"selfLink\": string, \"value\": string, \"visibility\": string, \"kind\": string, \"etag\": string, \"key\": string } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `selfLink` | `string` Output only. The link back to this property. |\n| `value` | `string` The value of this property. |\n| `visibility` | `string` The visibility of this property. Allowed values are PRIVATE (default) and PUBLIC. Private properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties. |\n| `kind` | `string` Output only. This is always `drive#property`. |\n| `etag` | `string` Output only. ETag of the property. |\n| `key` | `string` The key of this property. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------|----------------------------------------------------------------|\n| ### [delete](/workspace/drive/api/reference/rest/v2/properties/delete) | Deletes a property. |\n| ### [get](/workspace/drive/api/reference/rest/v2/properties/get) | Gets a property by its key. |\n| ### [insert](/workspace/drive/api/reference/rest/v2/properties/insert) | Adds a property to a file, or updates it if it already exists. |\n| ### [list](/workspace/drive/api/reference/rest/v2/properties/list) | Lists a file's properties. |\n| ### [patch](/workspace/drive/api/reference/rest/v2/properties/patch) | Updates a property. |\n| ### [update](/workspace/drive/api/reference/rest/v2/properties/update) | Updates a property. |"]]