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

Cette page est-elle utile ?

D'autres commentaires ?

Les commentaires seront envoyés à Microsoft : en appuyant sur le bouton envoyer, vos commentaires seront utilisés pour améliorer les produits et services Microsoft. Politique de confidentialité.

La plupart des Kits de développement logiciel (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.

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification. 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 Microsoft.Graph. Package bêta. L’utilisation est la même que celle du Microsoft.Graph package.

using Microsoft.Graph;

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

TypeScript

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

• Vous pouvez définir la version sur le moment où vous la MicrosoftGraph.Client créez. 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 demande 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 Bêta microsoft Graph. L’utilisation est identique au 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, vous remplacez simplement cela par https://graph.microsoft.com/beta.

Toutefois, les modèles du Kit de développement logiciel (SDK) Microsoft Graph Models sont générés à partir d’objets de l’API v1.0. Ils peuvent donc 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 bêta et les modèles. Vous définissez le point de terminaison bêta avec la setApiVersion méthode. Vous devez ambiguïté les 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() ";
    }
}

Go

Important

Le SDK Microsoft Graph pour Go est actuellement en prévisualisation. L’utilisation de ce SDK en production n’est pas prise en charge.

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

import (
    msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
    a "github.com/microsoft/kiota-authentication-azure-go"
)

auth, err := a.NewAzureIdentityAuthenticationProviderWithScopes(...)

adapter, err := msgraphsdk.NewGraphRequestAdapter(auth)

client := msgraphsdk.NewGraphServiceClient(adapter)