REST Resource: properties
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: Property
Ein Schlüssel/Wert-Paar, das an eine Datei angehängt ist und entweder öffentlich oder privat für eine Anwendung ist.
Für Dateieigenschaften gelten die folgenden Einschränkungen:
- Maximal 100 Unterkünfte pro Datei
- Maximal 30 private Properties pro App
- Maximal 30 öffentliche Properties
- Maximale Größe von 124 Byte für den String (Schlüssel + Wert) in UTF-8-Codierung für eine einzelne Property
Für einige Ressourcenmethoden (z. B. properties.update) ist eine propertyKey erforderlich. Verwenden Sie die Methode properties.list, um den Schlüssel für eine Property abzurufen.
| JSON-Darstellung |
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
| Felder |
selfLink |
string
Nur Ausgabe. Der Link zurück zu dieser Property.
|
value |
string
Der Wert dieser Property.
|
visibility |
string
Die Sichtbarkeit dieser Property. Zulässige Werte sind PRIVATE (Standard) und PUBLIC. Private Unterkünfte können nur mit einer authentifizierten Anfrage abgerufen werden. Eine authentifizierte Anfrage verwendet ein Zugriffstoken, das mit einer OAuth 2-Client-ID abgerufen wurde. Sie können keine privaten Unterkünfte mit einem API-Schlüssel abrufen.
|
kind |
string
Nur Ausgabe. Dies ist immer drive#property.
|
etag |
string
Nur Ausgabe. ETag der Property.
|
key |
string
Der Schlüssel dieser Property.
|
Methoden |
|
|
Löscht eine Property. |
|
|
Ruft eine Property anhand ihres Schlüssels ab. |
|
|
Fügen Sie einer Datei ein Attribut hinzu oder aktualisieren Sie es, falls es bereits vorhanden ist. |
|
|
Hier werden die Eigenschaften einer Datei aufgelistet. |
|
|
Aktualisiert eine Property. |
|
|
Aktualisiert eine Property. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
