channel: archive

  • Artículo

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.

Archivar 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 se archivarán automáticamente.

El archivado es asincrónico; un canal se archiva después de que la operación de archivado asincrónico se complete correctamente, lo que podría producirse después de que se devuelva la respuesta.

No se puede archivar un canal sin propietario o que pertenece a un grupo que no tiene propietario.

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

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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 administradores globales y 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

Encabezado Valor
Authorization {token} de portador. Obligatorio.

Cuerpo de la solicitud

En la solicitud, opcionalmente puede incluir el shouldSetSpoSiteReadOnlyForMembers parámetro en un cuerpo JSON, como se indica a continuación.

{
    "shouldSetSpoSiteReadOnlyForMembers": true
}

Este parámetro opcional 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 se establece en false o se omite el cuerpo por completo, se omite este paso.

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 contiene 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: Archivar un canal

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

Solicitud

POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 202 Accepted
Location: /teams/{team-id}/operations/{operation-id}
Content-Type: text/plain
Content-Length: 0

Ejemplo 2: Archivar un canal cuando se archiva el equipo

En el ejemplo siguiente se muestra una solicitud cuando se archiva el equipo.

Solicitud

POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/archive

Respuesta

En el ejemplo siguiente se muestra la respuesta de 400 error.

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"
        }
    }
}