Anlage hinzufügenAdd attachment

Namespace: Microsoft. GraphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Fügen Sie beim Erstellen eines Gruppenbeitrags eine Anlage hinzu.Add an attachment when creating a group post.

Dieser Vorgang schränkt die Größe der Anlage ein, die Sie unter 4 MB hinzufügen können.This operation limits the size of the attachment you can add to under 4 MB.

Eine Anlage weist einen der folgenden Typen auf:An attachment can be one of the following types:

All diese Typen von Anlagenressourcen werden von der Ressource attachment abgeleitet.All these types of attachment resources are derived from the attachment resource.

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) Group.ReadWrite.AllGroup.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Group.ReadWrite.AllGroup.ReadWrite.All

HTTP-AnforderungHTTP request

Einschließen einer Anlage beim Erstellen eines Beitrags in einem conversationThread einer Gruppe.Include an attachment when creating a post in a conversationThread of a group. Die Angabe der übergeordneten unter Haltung ist optional.Specifying the parent conversation is optional.

POST /groups/{id}/threads/{id}/reply
POST /groups/{id}/conversations/{id}/threads/{id}/reply

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Stellen Sie im Anforderungstext ein JSON-Objekt bereit, das einen Post -Parameter enthält.In the request body, provide a JSON object that includes a post parameter.

ParameterParameter TypType BeschreibungDescription
Beitragpost postpost Der neue Beitrag, auf den geantwortet wird, der eine oder mehrere Anlagen in einer Attachment -Auflistung enthält.The new post that is being replied with, which includes one or more attachments in an attachment collection.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben. Es wird keine Antworttext zurückgegeben.If successful, this method returns 202 Accepted response code. It does not return a response body.

BeispieleExamples

Beispiel 1: Einschließen einer DateianlageExample 1: Include a file attachment

AnforderungRequest

Hier ist ein Beispiel für eine Anforderung, die beim Erstellen eines Beitrags eine Datei als Anlage enthält.Here is an example of a request that includes a file as an attachment when creating a post.

POST https://graph.microsoft.com/beta/groups/1848753d-185d-4c08-a4e4-6ee40521d115/threads/AAQkADJUdfolA==/reply
Content-type: application/json

{
  "post": {
    "body": {
      "contentType": "text",
      "content": "Which quarter does that file cover? See my attachment."
    },
    "attachments": [{
      "@odata.type": "#microsoft.graph.fileAttachment",
      "name": "Another file as attachment",
      "contentBytes": "VGhpcyBpcyBhIGZpbGUgdG8gYmUgYXR0YWNoZWQu"
    } ]
  }
}

AntwortResponse

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

HTTP/1.1 202 Accpted

Beispiel 2: Einschließen einer ElementanlageExample 2: Include an item attachment

AnforderungRequest

Es folgt ein Beispiel für eine Anforderung, die beim Erstellen eines Beitrags ein Ereignis als Anlage enthält.Here is an example of a request that includes an event as an attachment when creating a post.

POST https://graph.microsoft.com/beta/groups/1848753d-185d-4c08-a4e4-6ee40521d115/threads/AAQkADJUdfolA==/reply
Content-type: application/json

{
  "post": {
    "body": {
      "contentType": "text",
      "content": "I attached an event."
    },
    "attachments": [{
      "@odata.type": "#microsoft.graph.itemAttachment",
      "name": "Holiday event", 
      "item": {
          "@odata.type": "microsoft.graph.event",
          "subject": "Discuss gifts for children",
          "body": {
              "contentType": "HTML",
              "content": "Let's look for funding!"
          },
          "start": {
              "dateTime": "2019-12-02T18:00:00",
              "timeZone": "Pacific Standard Time"
          },
          "end": {
              "dateTime": "2019-12-02T19:00:00",
              "timeZone": "Pacific Standard Time"
          }
      }
    } ]
  }
}

AntwortResponse

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

HTTP/1.1 202 Accepted

Beispiel 3: Einschließen einer ReferenzanlageExample 3: Include a reference attachment

AnforderungRequest

Nachfolgend finden Sie ein Beispiel für eine Anforderung, die beim Erstellen eines Beitrags eine Referenzanlage enthält.Here is an example of a request that includes a reference attachment when creating a post. Die Anlage verweist auf einen Ordner auf OneDrive.The attachment points to a folder on OneDrive.

POST https://graph.microsoft.com/beta/groups/1848753d-185d-4c08-a4e4-6ee40521d115/threads/AAQkADJUdfolA==/reply
Content-type: application/json

{
  "post": {
    "body": {
      "contentType": "text",
      "content": "I attached a reference to a file on OneDrive."
    },
    "attachments": [{
      "@odata.type": "#microsoft.graph.referenceAttachment", 
      "name": "Personal pictures", 
      "sourceUrl": "https://contoso.com/personal/mario_contoso_net/Documents/Pics", 
      "providerType": "oneDriveConsumer", 
      "permission": "Edit", 
      "isFolder": "True"
    } ]
  }
}

AntwortResponse

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

HTTP/1.1 202 Accpted