Zum Hauptinhalt springen

Wie du Aufnahmen mit Ordnern und Tags organisierst

Ordner und Tags sorgen dafür, dass eine wachsende Zahl von Aufnahmen auffindbar bleibt, und über Ordner entscheidest du, wer was sieht. Diese Anleitung zeigt, wie du beides über die API nutzt.

Vorher lesen

Lies zuerst den Schnellstart.

Schnellnavigation

  1. Ordner
  2. Ordner freigeben
  3. Tags

1. Ordner​

Ordner bilden einen Baum: Ein Ordner kann einen übergeordneten Ordner haben (parentFolderId), und eine Aufnahme lässt sich einem Ordner hinzufügen und wieder daraus entfernen.

PUT    /v1.0/directories/{directoryId}/folders/{folderId}/recordings/{recordingId}
DELETE /v1.0/directories/{directoryId}/folders/{folderId}/recordings/{recordingId}

Die Liste der Aufnahmen eines Ordners kann mit includeSubfolders=true auch Unterordner einschließen.

2. Ordner freigeben​

Freigegeben wird auf Ordnerebene, an einzelne Nutzer oder an ganze Teams. Das ist der praktische Weg, einer Abteilung eine Reihe von Meetings zu öffnen, ohne jede Aufnahme einzeln anzufassen. Beim Setzen der Freigaben wird die komplette Liste ersetzt.

PUT /v1.0/directories/{directoryId}/folders/{folderId}/shares

Referenz: PUT/v1.0/directories/{directoryId}/folders/{folderId}/shares

3. Tags​

Tags sind Etiketten an Terminen und Aufnahmen. Sie werden einmal je Unternehmenskonto im Tag-Katalog angelegt, tragen eine Farbe aus einer festen Palette (zum Beispiel blue oder green) und werden danach per Id zugewiesen. Den Katalog verwalten Admins und Owner.

PUT /v1.0/directories/{directoryId}/recordings/{recordingId}/tags

{ "tagIds": ["…"] }
Wichtig

Beim Zuweisen wird die komplette Tag-Liste ersetzt, und es werden nur Ids vorhandener Tags angenommen. Leg einen fehlenden Tag also zuerst an und weise ihn dann zu. Eine Aufnahme oder ein Termin kann bis zu 20 eigene Tags tragen.