Obtener filesFolder

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.

Obtenga los metadatos de la ubicación en donde se almacenan los archivos de un canal.

Nota:

Algunos caracteres especiales en el nombre del canal harán que esta API devuelva un error. Para obtener más información, consulte Problemas conocidos.

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) Files.Read.All Files. Read, Files. ReadWrite, Files. ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) Files.Read Files. Read.All, Files. ReadWrite, Files. ReadWrite.All
Aplicación Files.Read.All File.Read.Group, Files. ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Nota:

  • El permiso File.Read.Group utiliza el consentimiento específico del recurso.
  • Los permisos Group.Read.All y Group.ReadWrite.All solo se admiten por motivos de compatibilidad con versiones anteriores. Se recomienda actualizar las soluciones para usar un permiso alternativo enumerado en la tabla anterior y así evitar el uso de estos permisos en el futuro.

Solicitud HTTP

GET /teams/{id}/channels/{id}/filesFolder

Parámetros de consulta opcionales

Este método no admite los parámetros de consulta OData para personalizar la respuesta.

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.

Cuerpo de la solicitud

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

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y un objeto driveItem en el cuerpo de la respuesta.

Nota:

  • Para los canales privados creados antes del paso al cumplimiento de grupos como parte de las mejoras, es posible que siga existiendo una carpeta dedicada que coincida con el nombre del canal. Todos los archivos cargados antes de la mejora permanecen en esta carpeta.

  • Después de migrar un canal privado, la ubicación predeterminada del archivo cambia a la carpeta raíz y la GET /teams/{team-id}/channels/{channel-id}/filesFolder API devuelve el driveItemarchivo . Los canales privados recién creados (posteriores a la migración) ya no crean una carpeta dedicada. Todos los archivos se almacenan en la carpeta raíz y la API devuelve el driveItemarchivo .

Para obtener más información sobre las mejoras y la migración de canales privados, consulte Nuevas mejoras en canales privados en Microsoft Teams.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/teams/{id}/channels/{id}/filesFolder

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('32e3b156-66b2-4135-9aeb-73295a35a55b')/channels('19%3Af253e46c035b42308e9a4a22a87037af%40thread.skype')/filesFolder/$entity",
    "id": "01H7CFEKENJSSIUHGADZBKODARINQC5JMD",
    "createdDateTime": "0001-01-01T00:00:00Z",
    "lastModifiedDateTime": "2020-01-23T18:47:13Z",
    "lastEditedDateTime": null,
    "name": "Documentation Planning",
    "webUrl": "https://microsoft.sharepoint.com/teams/ExtensibilityandFundamentals/Shared%20Documents/Documentation%20Planning",
    "size": 2374080,
    "parentReference": {
        "driveId": "b!2SInBlQrN0K8-GXMy9qNsPtI5ScW8C5IlZtycoy6ZpJZRRtgE4qVTrE8wrvL0-hd",
        "driveType": "documentLibrary"
    },
    "fileSystemInfo": {
        "createdDateTime": "2020-01-23T18:47:12Z",
        "lastModifiedDateTime": "2020-01-23T18:47:13Z",
    },
    "folder": {
        "childCount": 7
    }
}
  • Last updated on