teams_read_transcript

macOS

Objectif

Lit la transcription d’un appel Microsoft Teams lancé depuis une discussion ou d’une réunion de calendrier (transcript_id issu de teams_list_transcripts) sous forme de lignes «HH:MM · personne : texte», dans le fuseau horaire de cet ordinateur, de la plus ancienne à la plus récente. Lecture seule. Un appel exige l’autorisation Microsoft 365 CallTranscripts.Read.All, et une réunion OnlineMeetingTranscript.Read.All et OnlineMeetings.Read ; un administrateur de l’organisation doit approuver celle de la transcription : sans elle, la réponse est consent_required et indique ce qu’il faut demander à l’administrateur. Lorsque l’organisation a désactivé l’accès aux transcriptions ou masque qui a parlé, la réponse le dit (speakers: false signifie que les lignes n’ont pas de personne). Renvoie au plus limit lignes (500 par défaut, 2000 au maximum) ; une transcription plus longue porte truncated: true. Nécessite un compte professionnel ou scolaire Microsoft 365 connecté avec connect_m365_account.

Entrées requises

• transcript_id

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "limit": {
      "description": "Max lines to return (default 500, at most 2000)",
      "type": "integer"
    },
    "transcript_id": {
      "description": "Transcript ID from teams_list_transcripts (call:... or meeting:...)",
      "type": "string"
    }
  },
  "required": [
    "transcript_id"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour teams_read_transcript. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "limit": 200,
  "transcript_id": "demo-transcript-1"
}