ERYEM Camp - Octobre 2015

OFFICE 365 GROUPSREST API

Soumaya Toumi Consultante SharePoint @ ERYEM Jeune SharePointiste qui évolue

autour des technologies Microsoft, en particulier SharePoint, Yammer et Office 365.

Communautés Microsoft

Contact : stoumi@eryem.com

Groupes Office 365C’est quoi ?

Groupes Office 365, C’est quoi ?

Groupes Office 365REST API

Groupes Office 365, REST API L’accès à l’API s’effectue à travers une API Unifiée L’API Unifié offre un unique REST API EndPoint pour

accéder : Aux fichiers Aux calendriers

Aux contacts Et les groupes

Groupes Office 365, REST API

Groupes Office 365, REST API 4 Requêtes HTTP : GET, POST, PATCH, DELETE Toutes les requêtes des groupes utilisent l’url : https://graph.microsoft.com/{version}/{tenant}

- https://graph.microsoft.com : Endpoint de l'API Unifiée- {version} : actuellement, on utilise l'alias : beta.- {tenant} : peut se décliner sous plusieurs formes :

ID du tenant (GUID) nom du domaine, par exemple : contoso.onmicrosoft.com l'alias myOrganization : Récupère automatiquement celui de

l'utilisateur authentifié

REST API : Exemple 1 Récupérer tous les groupes de votre organisation :

https://graph.microsoft.com/beta/contoso.com/groups ou

https://graph.microsoft.com/beta/myorganization/groups

Récupérer uniquement les groupes Office 365:https://graph.microsoft.com/beta/contoso.com/groups?$filter=groupTypes/any(c:c+eq+'Unified')

-> Nécessite le droit : Group.Read.All

REST API : Exemple 1 Renvoyer une liste de « Group »

REST API : Exemple 2 Créer un groupe :

POST https://graph.microsoft.com/beta/contoso.com/groups Content-Type: application/json { "groupTypes": ["Unified"], "description": "Let's see the world", "displayName": "Travellers Group", "mailNickname": "Travellers", "mailEnabled": "true", "securityEnabled": "true" }-> Nécessite le droit : Group.ReadWrite.All

REST API : Exemple 2 Renvoyer un « Group »

REST API : Exemple 3 Ajouter un membre :

POST https://graph.microsoft.com/beta/contoso.com/groups('24968f9b-c954-4e05-9e22-93b2c71a4c4a')/members/$ref

Content-Type: application/json{"@odata.id": https://graph.microsoft.com/beta/myorganization/users/492c5308-59fd-4740-9c83-4b3db07a6d70 }

-> Nécessite le droit : Group.ReadWrite.All-> Le résultat OK est indiqué par un HTTP 200

REST API : Exemple 4 Récupérer les conversations d’un groupe :

POST https://graph.microsoft.com/beta/contoso.com/groups('24968f9b-c954-4e05-9e22-93b2c71a4c4a')/conversations

-> Nécessite le droit : Group.Read.All

REST API : Exemple 5 Récupérer tous les fichiers et dossiers d’un groupe :

POST https://graph.microsoft.com/beta/contoso.com/groups('24968f9b-c954-4e05-9e22-93b2c71a4c4a')/files

-> Nécessite le droit : Group.Read.All

Références https://dev.office.com/blogs/GroupsRESTAPI

https://msdn.microsoft.com/office/office365/HowTo/groups-rest-operations

Merci pour votre attention