Partager via


section : copyToSectionGroup

Espace de noms : microsoft.graph Copie une section dans un groupe de sections spécifique.

Pour les opérations de copie, vous suivez un modèle d’appel asynchrone : appelez d’abord l’action Copier, puis interrogez le point de terminaison de l’opération pour obtenir le résultat.

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

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Notes.Create Notes.ReadWrite, Notes.ReadWrite.All
Déléguée (compte Microsoft personnel) Notes.Create Notes.ReadWrite
Application Notes.ReadWrite.All Non disponible.

Requête HTTP

POST /me/onenote/sections/{id}/copyToSectionGroup
POST /users/{id | userPrincipalName}/onenote/sections/{id}/copyToSectionGroup
POST /groups/{id}/onenote/sections/{id}/copyToSectionGroup

En-têtes de demande

Nom Type Description
Autorisation string Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type string application/json

Corps de la demande

Dans le corps de la demande, fournissez un objet JSON qui contient les paramètres dont votre opération a besoin.

Paramètre Type Description
groupId Chaîne ID du groupe vers lequel effectuer la copie. Utilisez uniquement lors de la copie vers un groupe Microsoft 365.
id Chaîne Obligatoire. ID du groupe de sections de destination.
renameAs Chaîne Nom de la copie. La valeur par défaut est le nom de l’élément existant.

Réponse

Si elle réussit, cette méthode renvoie un 202 Accepted code de réponse et un Operation-Location en-tête. Interrogez le point de terminaison Operation-Location pour obtenir l’état de l’opération de copie.

Exemple

Voici comment vous pouvez appeler cette API.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/me/onenote/sections/{id}/copyToSectionGroup
Content-type: application/json

{
  "id": "id-value",
  "groupId": "groupId-value",
  "renameAs": "renameAs-value"
}
Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accepted