Ajouter une pièce jointe

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Ajoutez une pièce jointe lors de la création d’un billet de groupe.

Cette opération limite la taille de la pièce jointe à laquelle vous pouvez ajouter moins de 3 Mo.

Une pièce jointe peut être l’un des types suivants :

Tous ces types de ressources de pièce jointe dérivent de la ressource attachment.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Group.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Requête HTTP

Inclure une pièce jointe lors de la création d’une publication dans une conversationThread d’un groupe. La spécification de la conversation parente est facultative.

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

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

Dans le corps de la demande, fournissez un objet JSON qui inclut un paramètre de publication .

Paramètre Type Description
publier post Nouveau billet avec lequel est répondu, qui inclut une ou plusieurs pièces jointes dans une collection de pièces jointes .

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 202 Accepted. Il ne retourne pas de corps de réponse.

Exemples

Exemple 1 : Inclure une pièce jointe

Demande

L’exemple suivant montre une requête qui inclut un fichier en tant que pièce jointe lors de la création d’un billet.

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

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accpted

Exemple 2 : Inclure une pièce jointe d’élément

Demande

L’exemple suivant montre une requête qui inclut un événement en tant que pièce jointe lors de la création d’un billet.

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

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accepted

Exemple 3 : Inclure une pièce jointe de référence

Demande

L’exemple suivant montre une demande qui inclut une pièce jointe de référence lors de la création d’une publication. La pièce jointe pointe vers un dossier sur 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"
    } ]
  }
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accpted