Zum Hauptinhalt springen

Wie du das vollständige Transkript einer Aufnahme abrufst

Das Transkript ist die Grundlage, aus der Sally die Zusammenfassung erstellt: wer wann was gesagt hat. Diese Anleitung zeigt, was die Antwort enthält, wie du prüfst, ob ein Transkript existiert, und wie du die Antwort klein hältst.

Vorher lesen

Lies zuerst den Schnellstart und Termine, Aufnahmen und Zusammenfassungen.

Schnellnavigation

  1. Transkript abrufen
  2. Vorher den Status prüfen
  3. Die Antwort klein halten

1. Transkript abrufen​

GET /v1.0/directories/{directoryId}/recordings/{recordingId}/transcription

Die Antwort enthält zwei Listen, die zusammengehören:

  • speakers enthält je Stimme einen Eintrag mit speakerId, speakerNumber und, wo Sally es auflösen konnte, name und emailAddress.
  • segments enthält die zeitcodierten Sprachabschnitte mit startTime und endTime in Sekunden, dem text und einer speakerId aus der Liste speakers. Für den Sprecher eines Segments brauchst du also keinen zweiten Aufruf.

Referenz: GET/v1.0/directories/{directoryId}/recordings/{recordingId}/transcription

2. Vorher den Status prüfen​

Ein beendeter Transkriptionslauf ist nicht dasselbe wie ein vorhandenes Transkript. Sieh dir zuerst die Aufnahme an:

  • isTranscriptionCompleted: Der Lauf ist vorbei, wie auch immer er ausging.
  • isTranscriptionSucceeded: Es gibt ein brauchbares Transkript. Dieses Feld solltest du prüfen.
  • transcriptionCompletionReason: warum der Lauf endete, einer von succeeded, noSpokenAudio, fileEmpty, languageNotDetected, quotaExceeded, error oder unknown (läuft noch).

Referenz: GET/v1.0/directories/{directoryId}/recordings/{recordingId}

Das heißt

Ein Meeting, in dem niemand gesprochen hat, ergibt einen beendeten Lauf ohne Transkript. Das ist kein Fehler und braucht keinen zweiten Versuch, noSpokenAudio sagt es deutlich.

3. Die Antwort klein halten​

Wichtig

Transkripte sind die größten Antworten dieser API, und fast alles davon steckt in segments. Wenn du nur wissen willst, wer teilgenommen hat, frag ?fields=speakers ab. Die Segmente werden dann gar nicht erst gesendet. Die Regeln erklärt Feldauswahl.