canal : getAllRetainedMessages

Espace de noms: microsoft.graph

Obtenez tous les messages conservés sur tous les canaux d’une équipe.

Pour en savoir plus sur l'utilisation des API d'exportation Microsoft Teams pour exporter du contenu, consultez Exporter du contenu avec les API d'exportation Microsoft Teams.

Remarque

Cette API nécessite la configuration des stratégies de rétention Teams . Pour plus d’informations, consultez En savoir plus sur la rétention de Microsoft Teams.

Remarque

Teams a migré le stockage de messages de canal privé des boîtes aux lettres utilisateur individuelles vers des boîtes aux lettres de groupe, où sont stockés les messages de canal standard. Pour les canaux privés, cette API prend en charge l’historique des messages conservés pour les messages modifiés ou supprimés après la migration du stockage du client, à condition qu’une stratégie de rétention applicable ait capturé les versions. Les modifications ou suppressions qui se sont produites avant la migration ne sont pas renvoyées, car la prise en charge de l’historique conservé n’était pas disponible via cette API pendant la période de stockage de la boîte aux lettres utilisateur héritée.

Un administrateur client peut exécuter Get-TenantPrivateChannelMigrationStatus pour vérifier que MigrationStatus is Completed et identifier le MigrationCompletionTimeStamp. Si MigrationStatus ce n’est pas Completed, MigrationCompletionTimeStamp n’est pas disponible et ne peut pas être utilisé comme une limite à l’échelle du client. Pour plus d’informations sur la modification du stockage, consultez Migration des messages des canaux privés en 2025.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) Non prise en charge. Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application ChannelMessage.Read.All Non disponible.

Requête HTTP

GET /teams/{teamsId}/channels/getAllRetainedMessages

Paramètres facultatifs de la requête

Cette méthode prend en charge les paramètres de requête OData suivants pour personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.

Nom Description
$filter Le paramètre de requête $filter prend en charge les requêtes de plage de dates et d’heures sur la propriété lastModifiedDateTime .
$top Utilisez le paramètre de requête $top pour contrôler le nombre d’éléments par réponse.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette fonction renvoie un code de réponse 200 OK et une collection d’objets chatMessage dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

GET https://graph.microsoft.com/v1.0/teams/8b081ef6-4792-4def-b2c9-c363a1bf41d5/channels/getAllRetainedMessages

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(chatMessage)",
  "@odata.count": 2,
  "@odata.nextLink": "https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/getAllRetainedMessages?$skip=2",
  "value": [
    {
      "@odata.type": "#microsoft.graph.chatMessage",
      "id": "1616990417393",
      "replyToId": null,
      "etag": "1616990417393",
      "messageType": "message",
      "createdDateTime": "2021-03-29T04:00:17.393Z",
      "lastModifiedDateTime": "2021-03-29T04:00:17.393Z",
      "lastEditedDateTime": null,
      "deletedDateTime": null,
      "subject": null,
      "summary": null,
      "chatId": null,
      "importance": "normal",
      "locale": "en-us",
      "webUrl": "https://teams.microsoft.com/l/message/19%3Ad5d2708d408c41d98424c1c354c19db3%40thread.tacv2/1616990417393?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1616990417393&parentMessageId=1616990417393",
      "policyViolation": null,
      "eventDetail": null,
      "from": {
        "application": null,
        "device": null,
        "conversation": null,
        "user": {
          "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
          "displayName": "Robin Kline",
          "userIdentityType": "aadUser"
        }
      },
      "body": {
        "contentType": "text",
        "content": "Test message"
      },
      "channelIdentity": {
        "teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
        "channelId": "19:d5d2708d408c41d98424c1c354c19db3@thread.tacv2"
      },
      "attachments": [],
      "mentions": [],
      "reactions": []
    },
    {
      "@odata.type": "#microsoft.graph.chatMessage",
      "id": "1616990171266",
      "replyToId": "1616990032035",
      "etag": "1616990171266",
      "messageType": "message",
      "createdDateTime": "2021-03-29T03:56:11.266Z",
      "lastModifiedDateTime": "2021-03-29T03:56:11.266Z",
      "lastEditedDateTime": null,
      "deletedDateTime": null,
      "subject": null,
      "summary": null,
      "chatId": null,
      "importance": "normal",
      "locale": "en-us",
      "webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1616990171266?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1616990171266&parentMessageId=1616990032035",
      "policyViolation": null,
      "eventDetail": null,
      "from": {
        "application": null,
        "device": null,
        "conversation": null,
        "user": {
          "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
          "displayName": "Robin Kline",
          "userIdentityType": "aadUser"
        }
      },
      "body": {
        "contentType": "text",
        "content": "Hello World"
      },
      "channelIdentity": {
        "teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b",
        "channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2"
      },
      "attachments": [],
      "mentions": [],
      "reactions": []
    }
  ]
}

Contenu connexe

Limites de limitation spécifiques au service Microsoft Graph

  • Dernière mise à jour :