REST Resource: properties
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: Mülk
Bir dosyaya eklenmiş, uygulama için herkese açık veya özel olan bir anahtar/değer çifti.
Dosya özellikleri için aşağıdaki sınırlar geçerlidir:
- Dosya başına maksimum 100 mülk
- Uygulama başına en fazla 30 özel mülk
- Maksimum 30 herkese açık mülk
- Tek bir mülk için UTF-8 kodlamasında (anahtar + değer) dizesinde maksimum 124 bayt boyut sınırı
Bazı kaynak yöntemleri (properties.update
gibi) propertyKey
gerektirir. Bir mülkün anahtarını almak için properties.list
yöntemini kullanın.
JSON gösterimi |
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
Alanlar |
selfLink |
string
Yalnızca çıkış. Bu mülke giden bağlantı.
|
value |
string
Bu özelliğin değeri.
|
visibility |
string
Bu mülkün görünürlüğü. İzin verilen değerler PRIVATE (özel) ve PUBLIC'tir (herkese açık). Gizli mülkler yalnızca kimliği doğrulanmış bir istek kullanılarak alınabilir. Kimliği doğrulanmış isteklerde OAuth 2 istemci kimliğiyle elde edilen bir erişim jetonu kullanılır. Özel mülkleri almak için API anahtarı kullanamazsınız.
|
kind |
string
Yalnızca çıkış. Bu değer her zaman drive#property olur.
|
etag |
string
Yalnızca çıkış. Mülkün ETag'ı.
|
key |
string
Bu mülkün anahtarı.
|
Yöntemler |
|
Bir mülkü siler. |
|
Bir mülkü anahtarına göre alır. |
|
Bir dosyaya mülk ekler veya mevcutsa mülkü günceller. |
|
Dosyanın özelliklerini listeler. |
|
Bir mülkü günceller. |
|
Bir mülkü günceller. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]