Freigabeeinladung sendenSend a sharing invitation

Sendet eine Freigabeeinladung für ein DriveItem-Element.Sends a sharing invitation for a DriveItem. Eine Freigabeeinladung stellt den Empfängern Berechtigungen zur Verfügung und sendet Ihnen optional eine e-Mail mit einem [Freigabe Link][].A sharing invitation provides permissions to the recipients and optionally sends them an email with a sharing link.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Files.ReadWrite, Files.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All
AnwendungApplication Files.ReadWrite.All, Sites.ReadWrite.AllFiles.ReadWrite.All, Sites.ReadWrite.All

HTTP-AnforderungHTTP request

POST /drives/{drive-id}/items/{item-id}/invite
POST /groups/{group-id}/drive/items/{item-id}/invite
POST /me/drive/items/{item-id}/invite
POST /sites/{siteId}/drive/items/{itemId}/invite
POST /users/{userId}/drive/items/{itemId}/invite

AnforderungstextRequest body

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.In the request body, provide a JSON object with the following parameters.

{
  "requireSignIn": false,
  "sendInvitation": false,
  "roles": [ "read | write"],
  "recipients": [
    { "@odata.type": "microsoft.graph.driveRecipient" },
    { "@odata.type": "microsoft.graph.driveRecipient" }
  ],
  "message": "string"
}
ParameterParameter TypType BeschreibungDescription
recipientsrecipients Collection(DriveRecipient)Collection(DriveRecipient) Eine Sammlung der Empfänger, die Zugriff und die Freigabeeinladung erhalten.A collection of recipients who will receive access and the sharing invitation.
messagemessage StringString Eine formatierte Nur-Text-Nachricht, die in der Freigabeeinladung enthalten ist. Die maximale Länge beträgt 2000 Zeichen.A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters.
requireSignInrequireSignIn BooleschBoolean Gibt an, ob der Empfänger der Einladung zur Anmeldung aufgefordert werden muss, um das freigegebene Element anzuzeigen.Specifies whether the recipient of the invitation is required to sign-in to view the shared item.
sendInvitationsendInvitation BooleanBoolean Bei true wird ein [Freigabe Link][] an den Empfänger gesendet.If true, a sharing link is sent to the recipient. Andernfalls wird eine Berechtigung direkt erteilt, ohne eine Benachrichtigung zu senden.Otherwise, a permission is granted directly without sending a notification.
rolesroles Collection(String)Collection(String) Geben Sie die Rollen an, die den Empfängern der Freigabeeinladung erteilt werden sollen.Specify the roles that are to be granted to the recipients of the sharing invitation.

BeispielExample

In diesem Beispiel wird eine Freigabeeinladung an einen Benutzer mit der e-Mail-Adresse "Ryan@contoso.com" mit einer Nachricht über eine Datei gesendet, an der die Zusammenarbeit erfolgt ist.This example sends a sharing invitation to a user with email address "ryan@contoso.com" with a message about a file being collaborated on. Die Einladung gewährt Ryan Lese-/ Schreibzugriff auf die Datei.The invitation grants Ryan read-write access to the file.

HTTP-AnforderungHTTP Request

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das permission-Sammlungsobjekt im Antworttext zurückgegeben.If successful, this method returns 200 OK response code and permission collection object in the response body.

POST /me/drive/items/{item-id}/invite
Content-type: application/json

{
  "recipients": [
    {
      "email": "ryan@contoso.com"
    }
  ],
  "message": "Here's the file that we're collaborating on.",
  "requireSignIn": true,
  "sendInvitation": true,
  "roles": [ "write" ]
}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response.

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

{
  "value": [
    {
      "grantedTo": {
        "user": {
          "displayName": "Ryan Gregg",
          "id": "42F177F1-22C0-4BE3-900D-4507125C5C20"
        }
      },
      "id": "CCFC7CA3-7A19-4D57-8CEF-149DB9DDFA62",
      "invitation": {
        "email": "ryan@contoso.com",
        "signInRequired": true
      },
      "roles": [ "write" ]
    }
  ]
}

HinweiseRemarks

  • Laufwerke mit demdriveTypepersonal (OneDrive Personal) können keine Berechtigungen am Stamm-DriveItem erstellen oder ändern.Drives with a driveType of personal (OneDrive personal) cannot create or modify permissions on the root DriveItem.
  • Eine Liste der verfügbaren Rollen finden Sie unter Rollenaufzählung.For a list of available roles, see Roles enumeration.

FehlerantwortenError Responses

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie im Thema Fehlerantworten.Read the Error Responses topic for more information about how errors are returned.