Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 20/06/2018

Notes de publication de l’API REST Office 365 d’avril 2015

Cette documentation couvre les fonctionnalités actuellement en préversion. Pour plus d’informations sur l’utilisation des fonctionnalités de la préversion, voir Aperçu des fonctionnalités développeur sur la plateforme Office 365.

Concerne : Office 365

Cet article fournit des informations sur les nouvelles fonctionnalités pour les développeurs qui sont disponibles dans la version d’avril 2015 des APIs Office 365, ainsi que les problèmes connus qui peuvent vous être utiles. Pour plus d’informations sur le développement pour Office 365, voir Présentation de la plate-forme API Office 365.

Nouvelles fonctionnalités GA dans les APIs Office 365

Les nouvelles fonctionnalités de l’API Office 365 suivantes sont généralement disponibles :

  • Prise en charge du partage des ressources d’origine croisée (CORS), incluant :
    • Prise en charge de CORS dans Exchange
    • Prise en charge de CORS dans SharePoint
    • Prise en charge de CORS dans Microsoft Azure Active Directory (Azure AD)
  • Prise en charge de AppOnly dans Exchange
  • Prise en charge de AppOnly dans SharePoint
  • Prise en charge des portées d’authentification dans SharePoint (taxonomie, recherche, UPA)
  • Mises à jour des APIs Outlook, notamment :
    • Synchronisation pour les vues du calendrier
    • Rechercher les messages qui répondent à un critère spécifié
    • Filtres pour les types complexes
    • Prise en charge des Fuseaux horaires de Windows pour les heures de début et de fin dans l’API Calendrier. Voir les propriétés StartTimeZone et EndTimeZone dans l’entité Événement.
    • Ouverture d’un message ou d’un événement dans l’application web Outlook. Voir la propriété WebLink dans les entités Message et Événement.

Nouvelles fonctionnalités de la préversion dans les APIs Office 365

Les nouvelles fonctionnalités de l’API Office 365 suivantes sont généralement disponibles :

  • API Notes (préversion)
  • API OneDrive (préversion)
  • API unifiée Office 365 (préversion)
  • Office Graph (préversion)
  • API REST vidéo (préversion)
  • Pour les APIs Outlook :
    • API REST de Notifications pour Outlook (préversion) pour recevoir des notifications pour le courrier, les contacts et les événements
    • API REST de photos utilisateurs pour Outlook (préversion) pour obtenir des photos HD d’utilisateurs authentifiés
    • Propriétés étendues pour le courrier

Pour plus de détails sur les nouvelles fonctionnalités de la préversion, voir Aperçu des fonctionnalités développeur sur la plateforme Office 365.

Problèmes connus relatifs à l'API unifiée Office 365 (préversion)

Les problèmes suivants sont connus avec l’API unifiée Office 365 (préversion).

Groupes unifiés et disponibilité des analyses des activités sociales

Pour la préversion, l’accès aux événements de groupe unifié et aux conversations peut prendre un certain temps pour devenir disponible dans le monde entier via l’API unifiée.

Limites de l’entité utilisateur

Pas d’accès instantané après création

Les utilisateurs peuvent être créés immédiatement via un POST sur l’entité utilisateur. Une licence Office 365 doit d’abord être attribuée à un utilisateur, afin d’accéder aux services Office 365. Même dans ce cas, en raison de la nature distribuée du service, il peut s’écouler environ 15 minutes avant que les fichiers, les messages et les entités d’événements soient disponibles pour cet utilisateur via l’API unifiée. Pendant ce temps, les applications recevront une erreur HTTP 404.

Paramétrer les propriétés étendues du profil utilisateur

Paramétrer les propriétés étendues du profil utilisateur comme AProposDeMoi et Compétences n’est actuellement pas pris en charge.

Limites de l’entité Groupe

Pas d’accès instantané des groupes au contenu après sa création

Les groupes unifiés peuvent être créés immédiatement via un POST sur l’entité de groupe. Toutefois, pour un groupe unifié créé à l’aide de l’API unifiée, l’accès au contenu associé ne sera pas disponible immédiatement. Les applications pourront commencer à ajouter du contenu au groupe (fichiers, conversations et événements) après une période définie comme suit :

  • Pour les conversations et les événements, jusqu’à 40 minutes après la création du groupe
  • Pour les fichiers, jusqu’à 24 heures après la création du groupe

Jusqu’à ce moment, les tentatives de mise à jour du groupe unifié avec du contenu entraîneront une erreur HTTP 500. Pour les applications de démonstration de faisabilité qui utilisent les API unifiées Office 365, nous vous recommandons d’utiliser Outlook ou l’application web Outlook pour créer un groupe unifié si un accès immédiat au contenu est requis.

Politique

Utiliser les APIs unifiées Office 365 pour créer et nommer un groupe unifié ignore les stratégies de groupe unifié configurées via l’application web Outlook. Pour les applications de démonstration de faisabilité qui utilisent les API unifiées Office 365, nous vous recommandons d’utiliser Outlook ou l’application web Outlook pour créer des groupes unifiés.

Étendues d’autorisation

L’API unifiée Office 365 expose deux étendues d’autorisations pour les groupes unifiés :

  • Group.Read.All
  • Group.ReadWrite.All

Ces étendues permettent d’accéder aux fonctions de gestion de groupe (énumération des groupes, énumération des membres du groupe) ainsi qu’au contenu du groupe (conversations et événements). Cependant, pour accéder aux fichiers d’un groupe unifié, vous devez également demander l’étendue d’autorisation Sites.Read.All ou Site.ReadWrite.All. Pour plus d’informations sur ces étendues d’autorisation, voir Premiers pas avec l’API unifiée Office 365 (préversion).

Contacts

Les contacts personnels ne sont actuellement pas pris en charge. Seuls les contacts organisationnels sont pris en charge.

Opérations OData

La recherche/Le filtrage entre charges de travail n’est pas disponible. La recherche en texte intégral (à l'aide $search) n’est disponible que pour les utilisateurs, les groupes, les contacts de l’organisation, les messages et les événements.

Niveau de performance SLA

La latence de requête pour le 95ème centile peut être élevée.

Incompatibilités de schéma

Les ID canoniques pour les participants et les destinataires ne sont pas disponibles.

Téléchargement de fichiers dans un dossier particulier

Une application souhaitant télécharger un fichier dans un dossier spécifique doit effectuer trois étapes :

  1. Créer un nouveau fichier dans le dossier racine.

  2. Télécharger le contenu du fichier.

  3. Déplacer le fichier dans le dossier cible.

Les étapes 2 et 3 sont interchangeables. En outre, pour créer un dossier sous un autre dossier, vous devez créer le nouveau dossier sous le dossier racine, puis vous pourrez le déplacer vers le dossier cible souhaité. Nous allons résoudre ces problèmes afin que ces opérations ne nécessitent qu’un seul appel.

Streaming de fichier et de contenu

Le téléchargement de fichiers (fichiers dans les groupes unifiés, les lecteurs ou les pièces jointes d’un e-mail) est limité à 1 Mo.

Compatibilité d’enregistrement des applications

Pendant la période de préversion, vous devriez enregistrer vos nouvelles applications pour appeler l’API unifiée Office 365. Les applications mono et multi-locataires sont prises en charge pour les applications Web. Les applications clientes natives ne peuvent être utilisées que dans la location dans laquelle l’application est enregistrée.

Problèmes connus des API Outlook

Impossible de définir des rappels pour les événements

Vous ne pouvez pour l’instant pas définir de rappel depuis la bibliothèque client ou directement via REST lorsque vous créez ou mettez à jour des événements. Le champ rappel d’événement n’est pas mis à jour, mais aucune erreur n’est renvoyée.

Ressources supplémentaires

© 2018 Microsoft