Ressource: Property
Ein Schlüssel/Wert-Paar, das an eine Datei angehängt ist, die für eine Anwendung entweder öffentlich oder privat ist.
Für Dateieigenschaften gelten die folgenden Beschränkungen:
- Maximal 100 Properties 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 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 | |
---|---|
selfLink |
Nur Ausgabe Die Verknüpfung zurück zu dieser Property. |
value |
Der Wert dieser Eigenschaft. |
visibility |
Die Sichtbarkeit dieser Property. Zulässige Werte sind PRIVATE (Standardeinstellung) und PUBLIC. Private Properties 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 keinen API-Schlüssel verwenden, um private Attribute abzurufen. |
kind |
Nur Ausgabe Dies ist immer |
etag |
Nur Ausgabe Das ETag der Property. |
key |
Der Schlüssel dieser Property. |
Methoden |
|
---|---|
|
Löscht eine Eigenschaft. |
|
Ruft eine Eigenschaft anhand ihres Schlüssels ab. |
|
Fügt einer Datei eine Eigenschaft hinzu oder aktualisiert sie, wenn sie bereits vorhanden ist |
|
Listet die Eigenschaften einer Datei auf. |
|
Aktualisiert eine Property. |
|
Aktualisiert eine Property. |