Partager via


conversationMember : ajouter

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 plusieurs membres à une équipe dans une seule demande. La réponse fournit des détails sur les appartenances que vous avez pu créer et que vous n’avez pas pu créer.

Remarque

Parfois, il faut du temps pour refléter l’ajout d’un membre après l’ajout de celui-ci. Les utilisateurs peuvent utiliser les notifications de modification pour s’abonner aux notifications relatives aux modifications d’appartenance dans une équipe particulière.

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

Requête HTTP

Il s’agit d’une action liée pour ajouter plusieurs éléments à une collection conversationMember dans une seule requête.

POST /teams/{team-id}/members/add

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, indiquez la représentation JSON de la liste des dérivés conversationMember à ajouter à l’équipe. Un maximum de 200 conversationMember dérivés peuvent être ajoutés en une seule requête.

Le tableau suivant indique les paramètres utilisables avec cette action.

Paramètre Type Description
values Collection conversationMember Liste des membres de conversation à ajouter.

Réponse

Si elle réussit, cette action renvoie un code de réponse 200 OK et un ensemble de dérivés de la ressource actionResultPart dans le corps de la réponse.

Cette API retourne une 200 réponse pour indiquer que tous les membres fournis ont été ajoutés à l’équipe, ou une 207 réponse pour indiquer que seuls certains des membres fournis ont été ajoutés à l’équipe. L’appelant doit inspecter la charge utile de réponse pour identifier les ajouts de membres qui ont échoué. Le corps de la réponse est un ensemble de dérivés de la ressource actionResultPart . Cette API répond avec une erreur en cas d’échec de la requête. Pour plus d’informations sur les erreurs Microsoft Graph, consultez Erreurs microsoft Graph et types de ressources.

Exemples

Exemple 1 : ajouter des membres en bloc à une équipe

Demande

L’exemple suivant montre une demande d’ajout de plusieurs membres à une équipe.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/add
Content-Type: application/json

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":[],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('18a80140-b0fb-4489-b360-2f6efaf225a0')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":["owner"],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('86503198-b81b-43fe-81ee-ad45b8848ac9')"
        }
    ]
}

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.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.aadUserConversationMemberResult)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "18a80140-b0fb-4489-b360-2f6efaf225a0",
            "error": null
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
            "error": null
        }
    ]
}

Exemple 2 : Ajouter des membres en bloc à une équipe à l’aide du nom d’utilisateur principal

Demande

L'exemple suivant montre une demande d'ajout de plusieurs membres à une équipe à l'aide du nom d'utilisateur principal des membres.

POST https://graph.microsoft.com/beta/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/add
Content-Type: application/json

{
    "values": [
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":[],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('jacob@contoso.com')"
        },
        {
            "@odata.type": "microsoft.graph.aadUserConversationMember",
            "roles":["owner"],
            "user@odata.bind": "https://graph.microsoft.com/beta/users('alex@contoso.com')"
        }
    ]
}

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.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.aadUserConversationMemberResult)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "18a80140-b0fb-4489-b360-2f6efaf225a0",
            "error": null
        },
        {
            "@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
            "userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
            "error": null
        }
    ]
}