REST Resource: properties

Ressource: Property

Ein Schlüssel/Wert-Paar, das an eine Datei angehängt ist, die entweder öffentlich oder privat für eine Anwendung ist.

Für Dateieigenschaften gelten die folgenden Limits:

  • Insgesamt maximal 100 Properties pro Datei
  • Maximal 30 private Properties pro App
  • Maximal 30 öffentliche Properties
  • Maximale Größe von 124 Byte für String (Schlüssel + Wert) in UTF-8-Codierung für ein einzelnes Attribut

Einige Ressourcenmethoden (z. B. properties.update) erfordern eine propertyKey. Verwenden Sie die Methode properties.list, um den Schlüssel für ein Attribut abzurufen.

JSON-Darstellung
{
  "selfLink": string,
  "value": string,
  "visibility": string,
  "kind": string,
  "etag": string,
  "key": string
}
Felder
value

string

Der Wert dieser Eigenschaft.

visibility

string

Die Sichtbarkeit dieser Property. Zulässige Werte sind PRIVATE (Standardeinstellung) und PUBLIC. Private Properties können nur mit einer authentifizierten Anfrage abgerufen werden. Bei einer authentifizierten Anfrage wird ein Zugriffstoken verwendet, das mit einer OAuth 2-Client-ID abgerufen wurde. Es ist nicht möglich, private Properties mit einem API-Schlüssel abzurufen.

kind

string

Nur Ausgabe. Dies ist immer drive#property.

etag

string

Nur Ausgabe. ETag der Eigenschaft.

key

string

Der Schlüssel dieser Eigenschaft.

Methoden

delete

Löscht eine Property.

get

Ruft eine Eigenschaft anhand ihres Schlüssels ab.

insert

Fügt einer Datei eine Eigenschaft hinzu oder aktualisiert sie, falls sie bereits vorhanden ist.

list

Listet die Attribute einer Datei auf.

patch

Aktualisiert eine Property.

update

Aktualisiert eine Property.