channel: unarchive

  • 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.

Restaure un canal archivado. La desarchividad restaura la capacidad de los usuarios para enviar mensajes y editar el canal. Los canales se archivan a través del método channel: archive .

Unarchiving es una operación asincrónica; un canal se desarchiva cuando la operación asincrónica de desarchivación se completa correctamente, lo que podría producirse después de que este método responda.

Nota: Un canal archivado que pertenece a un equipo archivado no se puede desarchivar. Desarchivar el equipo antes de desarchar el canal; De lo contrario, se produce un error en la solicitud.

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 usuarios con los roles de administrador global o administrador de servicio de Microsoft Teams pueden acceder a los equipos de los que no son miembros.

Solicitud HTTP

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

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

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

Ejemplos

Ejemplo 1: Desarchivo de un canal

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

Solicitud

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

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: Desarchivo de un canal cuando se archiva el equipo

En el ejemplo siguiente se muestra una solicitud para desarchivo de un canal que produce un error 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/unarchive

Respuesta

En el ejemplo siguiente se muestra el código de 400 Bad Request respuesta con un 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"
        }
    }
}