Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta

La plupart des sdk Microsoft Graph utilisent le point de terminaison Microsoft Graph v1.0 par défaut. Les Kits de développement logiciel (SDK) peuvent être utilisés avec le point de terminaison bêta pour les applications hors production. La méthode d’accès au point de terminaison bêta dépend du KIT de développement logiciel (SDK) que vous utilisez.

Importante

Les API sous la /beta version dans Microsoft Graph sont susceptibles de changer. 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 la version 1.0, utilisez le sélecteur de version .

C#

Pour appeler l’API bêta, vous devez installer le package Microsoft.Graph.Beta . L’utilisation est identique à celle du Microsoft.Graph package.

// Version 5.x
using Microsoft.Graph.Beta;
// Version 4.x and earlier
// using Microsoft.Graph;

// Create a new instance of GraphServiceClient.
GraphServiceClient graphClient = new GraphServiceClient(...);

TypeScript

La bibliothèque de client JavaScript Microsoft Graph peut appeler l’API bêta de l’une des deux manières suivantes.

• Vous pouvez définir la version sur le lors de sa MicrosoftGraph.Client création. Toutes les demandes effectuées par le client sont envoyées à la version spécifiée.

  const clientOptions: ClientOptions = {
    defaultVersion: 'beta',
    ...
  };
  
  // Initialize Graph client
  const client = MicrosoftGraph.Client.initWithMiddleware(clientOptions);
  

• Vous pouvez définir la version sur une requête spécifique à l’aide de la version fonction sur l’objet GraphRequest .

  const user = await client
    .api('/me')
    .version('beta')
    .get();
  

Java

Pour appeler l’API bêta, vous devez installer le Kit de développement logiciel (SDK) Java microsoft Graph bêta. L’utilisation est identique à celle du KIT de développement logiciel (SDK) non bêta.

GraphServiceClient graphClient = GraphServiceClient
    .builder()
    .authenticationProvider(authProvider)
    .buildClient();

Objective-C

Le Kit de développement logiciel (SDK) Microsoft Graph pour ObjC vous oblige à générer une chaîne d’URL vers l’API que vous souhaitez appeler. Il fournit une constante MSGraphBaseURL pour le point de terminaison v1.0. Pour utiliser la version bêta, il vous suffit de la remplacer par https://graph.microsoft.com/beta.

Toutefois, les modèles du Kit de développement logiciel (SDK) Modèles Microsoft Graph sont générés à partir d’objets dans l’API v1.0, de sorte qu’ils peuvent ne pas fonctionner avec des objets bêta.

// GET /me
NSString* meUrlString = [NSString stringWithFormat:@"%@/me", "https://graph.microsoft.com/beta"];

NSURL* meUrl = [[NSURL alloc] initWithString:meUrlString];

NSMutableURLRequest* meRequest = [[NSMutableURLRequest alloc] initWithURL:meUrl];

PHP

Le Kit de développement logiciel (SDK) Microsoft Graph pour PHP prend en charge le point de terminaison et les modèles bêta. Vous définissez le point de terminaison bêta avec la setApiVersion méthode . Vous devez lever l’ambiguïté des modèles v1.0 et bêta en fournissant un alias.

use Microsoft\Graph\Graph;
use Beta\Microsoft\Graph\Model as BetaModel;

class UseBeta
{
    public function run()
    {
        $accessToken = 'xxx';

        $graph = new Graph();
        $graph->setAccessToken($accessToken);

        $user = $graph->setApiVersion("beta")
                      ->createRequest("GET", "/me")
                      ->setReturnType(BetaModel\User::class)
                      ->execute();

        echo "Hello, I am $user->getGivenName() ";
    }
}

Activer

Importante

Le Kit de développement logiciel (SDK) Microsoft Graph pour Go est actuellement en préversion. L’utilisation de ce Kit de développement logiciel (SDK) en production n’est pas prise en charge.

Pour appeler l’API bêta, vous devez installer le package Microsoft Graph Beta SDK for Go .

import (
    msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
)
client := msgraphsdk.NewGraphServiceClientWithCredentials(credentials, scopes)

Voir aussi

Kits de développement logiciel (SDK) en préversion ou en disponibilité générale.