Canal: Archivo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Archivo un canal en un equipo. Cuando se archiva un canal, los usuarios no pueden enviar nuevos mensajes ni reaccionar a los mensajes existentes en el canal, editar la configuración del canal ni realizar otros cambios en el canal.

Puede eliminar un canal archivado o agregar y quitar miembros de él. Si archiva un equipo, sus canales también se archivan.

El archivado es una operación asincrónica; Un canal se archiva después de que la operación de archivado asincrónico se complete correctamente, lo que puede ocurrir después de que regrese la respuesta.

No se puede archivar un canal sin propietario o que pertenezca a un grupo que no tenga propietario.

Para restaurar un canal desde su estado archivado, use el método channel: unarchivar . Un canal no se puede archivar ni anular el archivado si su equipo está archivado.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) ChannelSettings.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación ChannelSettings.ReadWrite.All No disponible.

Nota: esta API admite permisos de administrador. Los usuarios con las funciones de administrador global o administrador de servicios de Microsoft Teams pueden acceder a los equipos de los que no son miembros.

Solicitud HTTP

POST /teams/{team-id}/channels/{channel-id}/archive
POST /groups/{team-id}/team/channels/{channel-id}/archive

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Opcional.

Cuerpo de la solicitud

En el cuerpo de la solicitud, puede proporcionar opcionalmente un objeto JSON con el siguiente parámetro.

Parámetro Tipo Descripción
shouldSetSpoSiteReadOnlyForMembers Booleano Define si se deben establecer permisos para que los miembros del canal sean de solo lectura en el sitio de SharePoint Online asociado al equipo. Si lo establece u false omite el parámetro, este paso se omitirá.

En el ejemplo siguiente se muestra el cuerpo de la solicitud con shouldSetSpoSiteReadOnlyForMembers establecido en true.

{
  "shouldSetSpoSiteReadOnlyForMembers": true
}

Respuesta

Si el archivado se inicia correctamente, este método devuelve un código de respuesta 202 Accepted. La respuesta contiene un Location encabezado que especifica la ubicación de teamsAsyncOperation que se creó para controlar el archivado del canal en un equipo. Compruebe el estado de la operación de archivado mediante una solicitud GET a esta ubicación.

Ejemplos

Ejemplo 1: Archivo un canal

En el ejemplo siguiente se muestra una solicitud para archivar un canal.

Solicitud

POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 202 Accepted
Location: /teams/16dc05c0-2259-4540-a970-3580ff459721/operations/b7ee702a-d87f-4cc6-82b9-e731c16d3aba
Content-Type: text/plain
Content-Length: 0

Ejemplo 2: Archivo un canal cuando se archiva el equipo

En el ejemplo siguiente se muestra una solicitud para archivar un canal que falla porque el equipo está archivado; El equipo debe estar activo para archivar o desarchivar un canal.

Solicitud

POST https://graph.microsoft.com/beta/teams/16dc05c0-2259-4540-a970-3580ff459721/channels/19:v32db348d9264477abcf18ffa2cf76dc@thread.tacv2/archive

Respuesta

En el ejemplo siguiente se muestra el código de 400 Bad Request respuesta con el mensaje de error correspondiente.

http/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 193

{
    "error": {
        "code": "BadRequest",
        "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
        "innerError": {
            "message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
            "code": "Unknown",
            "innerError": {},
            "date": "2023-12-11T04:26:35",
            "request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8",
            "client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe"
        }
    }
}
  • Last updated on