REST Resource: files

Ressource: Datei

Eine Datei, die in die API hochgeladen wurde.

JSON-Darstellung
{
  "name": string,
  "displayName": string,
  "mimeType": string,
  "sizeBytes": string,
  "createTime": string,
  "updateTime": string,
  "expirationTime": string,
  "sha256Hash": string,
  "uri": string
}
Felder
name

string

Nicht veränderbar. ID. Der Name der File-Ressource. Die ID (Name ohne das Präfix „files/“) kann bis zu 40 Zeichen (in Kleinbuchstaben) oder Bindestriche (-) enthalten. Die ID darf nicht mit einem Bindestrich beginnen oder enden. Wenn der Name beim Erstellen leer ist, wird ein eindeutiger Name generiert. Beispiel: files/123-456

displayName

string

Optional. Der visuell lesbare Anzeigename für File. Der Anzeigename darf maximal 512 Zeichen (einschließlich Leerzeichen) lang sein. Beispiel: „Willkommensbild“

mimeType

string

Nur Ausgabe Der MIME-Typ der Datei.

sizeBytes

string (int64 format)

Nur Ausgabe Größe der Datei in Byte.

createTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für die Erstellung des File.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für die letzte Aktualisierung von File.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

expirationTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für den Zeitpunkt, zu dem das File gelöscht wird. Wird nur festgelegt, wenn File ablaufen soll.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

sha256Hash

string (bytes format)

Nur Ausgabe SHA-256-Hash der hochgeladenen Byte.

Ein base64-codierter String.

uri

string

Nur Ausgabe Der URI von File.

Methoden

delete

Löscht die File.

get

Ruft die Metadaten für die angegebene File ab.

list

Listet die Metadaten für Files auf, die dem anfragenden Projekt gehören.