Verwenden der Microsoft Graph-SDKs mit der Beta-API

Viele der Microsoft Graph-SDKs verwenden standardmäßig den Microsoft Graph-Endpunkt v1.0. Die SDKs können mit dem Beta-Endpunkt für Nicht-Produktionsanwendungen verwendet werden. Die Methode für den Zugriff auf den Beta-Endpunkt hängt davon ab, welches SDK Sie verwenden.

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

C#

Um die Beta-API aufzurufen, müssen Sie die Microsoft.Graph installieren. Betapaket. Die Verwendung ist identisch mit dem Microsoft.Graph Paket.

// 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

Die Microsoft Graph JavaScript-Clientbibliothek kann die Beta-API auf eine von zwei Arten aufrufen.

• Sie können die Version MicrosoftGraph.Client beim Erstellen festlegen. Alle vom Client gestellten Anforderungen gehen an die angegebene Version.

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

• Sie können die Version für eine bestimmte Anforderung festlegen, indem Sie die version Funktion für das GraphRequest Objekt verwenden.

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

Java

Um die Beta-API aufzurufen, müssen Sie das Microsoft Graph Beta Java SDK installieren. Die Verwendung ist identisch mit dem Nicht-Beta-SDK.

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

Objective-C

Das Microsoft Graph SDK für ObjC erfordert, dass Sie eine URL-Zeichenfolge für die API erstellen, die Sie aufrufen möchten. Es stellt eine Konstante MSGraphBaseURL für den v1.0-Endpunkt bereit. Um Beta zu verwenden, ersetzen Sie dies einfach durch https://graph.microsoft.com/beta.

Die Modelle im Microsoft Graph Models SDK werden jedoch aus Objekten in der v1.0-API generiert, sodass sie möglicherweise nicht mit Betaobjekten funktionieren.

// 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

Das Microsoft Graph SDK für PHP unterstützt den Beta-Endpunkt und die Betamodelle. Sie legen den Beta-Endpunkt mit der setApiVersion Methode fest. Sie müssen die v1.0- und Betamodelle mithilfe eines Alias aufdeuten.

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

Wichtig

Das Microsoft Graph SDK for Go befindet sich derzeit in der Vorschau. Die Verwendung dieses SDK in der Produktion wird nicht unterstützt.

Um die Beta-API aufzurufen, müssen Sie das Paket Microsoft Graph Beta SDK for Go installieren.

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)