unidad: sharedWithMe (en desuso)

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.

Precaución

La API sharedWithMe está obsoleta y funcionará en un estado degradado hasta noviembre de 2026, tras lo cual dejará de devolver datos.

Obtener una lista de objetos driveItem compartidos con el propietario de una unidad.

Los elementos de unidad devueltos por el método sharedWithMe siempre incluyen la faceta remoteItem que indica que son elementos de una unidad diferente.

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

Nota:

  • Una /sharedWithMe solicitud se realiza correctamente con permisos OR Files.ReadWrite Sin Files.Read embargo, es posible que falten algunas propiedades.
  • No puede acceder a los elementos compartidos devueltos desde esta API si la solicitud no contiene uno de los *.All permisos.

Solicitud HTTP

GET /me/drive/sharedWithMe

Encabezados de solicitud

Nombre Descripción
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 tiene éxito, este método devuelve un 200 OK código de respuesta y una colección de objetos driveItem en el cuerpo de la respuesta.

De forma predeterminada, este método devuelve elementos compartidos dentro de su propio espacio empresarial. Para incluir elementos compartidos desde espacios empresariales externos, anexe ?allowexternal=true a una solicitud GET.

Ejemplos

Ejemplo 1: Compartir conmigo driveItems

En el ejemplo siguiente se obtiene una colección de recursos driveItem que se comparten con el propietario de la unidad.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/me/drive/sharedWithMe

Respuesta

En el ejemplo siguiente se muestra la respuesta que devuelve elementos compartidos con el usuario que ha iniciado sesión, porque la unidad es la unidad predeterminada del usuario.

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

{
  "value": [
    {
      "id": "1312abc",
      "remoteItem": {
        "id": "1991210caf!192",
        "name": "March Proposal.docx",
        "file": { },
        "size": 19121,
        "parentReference": {
          "driveId": "1991210caf",
          "id": "1991210caf!104"
        }
      }
    },
    {
      "id": "1312def",
      "remoteItem": {
        "id": "1991210caf!1991",
        "name": "Team Roster.xlsx",
        "file": { },
        "size": 37619,
        "parentReference": {
          "driveId": "1991210caf",
          "id": "1991210caf!104"
        }
      }
    },
    {
      "id": "1312ghi",
      "remoteItem": {
        "id": "987def!654",
        "name": "January Service Review.pptx",
        "file": { },
        "size": 145362,
        "parentReference": {
          "driveId": "987def",
          "id": "987def!321"
        }
      }
    }
  ]
}

Ejemplo 2: Obtener metadatos sobre un objeto driveItem compartido

En el ejemplo siguiente se muestra cómo acceder a los metadatos sobre el elemento de unidad compartido con el nombre January Service Review.pptx que requiere una solicitud mediante el driveId de parentReference dentro del objeto remoteItem .

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/drives/987def/items/987def!654

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

{
  "id": "987def!654",
  "name": "January Service Review.pptx",
  "file": { },
  "size": 145362,
  "parentReference": {
    "driveId": "987def",
    "id": "987def!321"
  }
}
  • Last updated on