Partager via


contentType : addCopyFromContentTypeHub

Espace de noms: microsoft.graph

Ajoutez ou synchronisez une copie d’un type de contenu publié à partir du hub de type de contenu vers un site cible ou une liste.

Cette méthode fait partie des modifications apportées à la publication du type de contenu pour optimiser la synchronisation des types de contenu publiés avec les sites et les listes, en passant d’une approche « push partout » à une approche « pull en fonction des besoins ». La méthode permet aux utilisateurs d’extraire des types de contenu directement du hub de type de contenu vers un site ou une liste. Pour plus d’informations, consultez contentType : getCompatibleHubContentTypes et le billet de blog Syntex Product Mises à jour – Août 2021.

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) Sites.Manage.All Sites.FullControl.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Sites.Manage.All Sites.FullControl.All

Requête HTTP

POST /sites/{siteId}/lists/{listId}/contentTypes/addCopyFromContentTypeHub
POST /sites/{siteId}/contentTypes/addCopyFromContentTypeHub

En-têtes de demande

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

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant montre le paramètre qui peut être utilisé avec cette action.

Paramètre Type Description
contentTypeId Chaîne ID du type de contenu dans le hub de type de contenu qui sera ajouté à un site cible ou à une liste.

Réponse

Si elle réussit, cette action renvoie un 200 OK code de réponse et un objet contentType dans le corps de la réponse si le type de contenu est ajouté de manière synchrone ou un 202 Accepted code de réponse si le type de contenu est synchronisé de manière asynchrone. La réponse contient également un Location en-tête, qui contient l’emplacement du richLongRunningOperation qui a été créé pour gérer l’opération de copie/synchronisation. En cas d’opération asynchrone, la synchronisation ou l’ajout d’un type de contenu peut prendre jusqu’à 70 minutes.

Exemples

Exemple 1 : extraction synchrone

L’exemple suivant ajoute ou synchronise un type de contenu de manière synchrone en fonction de certaines conditions principales.

Demande

Voici un exemple d’opération synchrone.

POST https://graph.microsoft.com/v1.0/sites/root/lists/Documents/contentTypes/addCopyFromContentTypeHub
Content-Type: application/json
Content-length: 33

{
  "contentTypeId": "0x0101"
}

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

{
    "@odata.type": "#microsoft.graph.contentType",
    "id": "0x0101",
    "description": "Document content type",
    "group": "Document Content Types",
    "hidden": false,
    "isBuiltIn": true,
    "name": "Document"
}

Exemple 2 : extraction asynchrone

L’exemple suivant ajoute ou synchronise un type de contenu de manière asynchrone, car les conditions principales d’une opération synchrone ne sont pas remplies.

Demande

Voici un exemple d’opération asynchrone.

POST https://graph.microsoft.com/v1.0/sites/root/lists/Documents/contentTypes/addCopyFromContentTypeHub
Content-Type: application/json
Content-length: 33

{
  "contentTypeId": "0x0101"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 202 Accepted
location: https://graph.microsoft.com/v1.0/sites/root/lists/Documents/operations/contentTypeCopy,0x0101