drive: sharedWithMe (en desuso)

Espacio de nombres: microsoft.graph

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

Los driveItems devueltos desde 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 nacionales de nube.

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.

Nota:

• Una /sharedWithMe solicitud se realiza correctamente con o Files.ReadWrite permisosFiles.Read; sin 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

Cuerpo de la solicitud

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

Respuesta

Si se ejecuta correctamente, 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 inquilino. Para incluir elementos compartidos desde inquilinos externos, anexe ?allowexternal=true a una solicitud GET.

Ejemplos

Ejemplo 1: Obtención de driveItems compartidos conmigo

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 inició 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 obtener acceso a los metadatos sobre el driveItem compartido con el nombre January Service Review.pptx que requiere una solicitud mediante el driveId del elemento 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

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
items, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

DriveItem result = graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").get();

const options = {
	authProvider,
};

const client = Client.init(options);

let driveItem = await client.api('/drives/987def/items/987def!654')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->get()->wait();

Import-Module Microsoft.Graph.Beta.Files

Get-MgBetaDriveItem -DriveId $driveId -DriveItemId $driveItemId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').get()

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