Использование пакетов SDK Microsoft Graph с бета-версией API

Многие пакеты SDK Microsoft Graph по умолчанию используют конечную точку Microsoft Graph версии 1.0 . Пакеты SDK можно использовать с бета-версией конечной точки для непроизводственных приложений. Метод доступа к конечной точке бета-версии зависит от используемого пакета SDK.

Важно!

Api в /beta версии Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий .

C#

Чтобы вызвать бета-версию API, необходимо установить пакет Microsoft.Graph.Beta . Использование совпадает с Microsoft.Graph использованием пакета.

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

Клиентская библиотека JavaScript в Microsoft Graph может вызывать бета-версию API одним из двух способов.

• Вы можете задать версию в при MicrosoftGraph.Client создании. Все запросы, выполненные клиентом, будут переходить на указанную версию.

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

• Версию можно задать для определенного запроса с помощью version функции объекта GraphRequest .

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

Java

Чтобы вызвать бета-версию API, необходимо установить пакет SDK для Java бета-версии Microsoft Graph. Использование совпадает с использованием пакета SDK, не являющегося бета-версией.

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

Objective-C

Пакет SDK Microsoft Graph для ObjC требует создания строки URL-адреса для API, который требуется вызвать. Он предоставляет константу MSGraphBaseURL для конечной точки версии 1.0. Чтобы использовать бета-версию, просто замените ее https://graph.microsoft.com/betaна .

Однако модели в пакете SDK моделей Microsoft Graph создаются из объектов в API версии 1.0, поэтому они могут не работать с бета-объектами.

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

Пакет SDK Microsoft Graph для PHP поддерживает бета-версию конечной точки и модели. Вы задаете бета-версию конечной setApiVersion точки с помощью метода . Вам потребуется дизамбигировать модели версии 1.0 и бета-версии путем предоставления псевдонима.

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

Важно!

Пакет SDK Microsoft Graph для Go в настоящее время находится в предварительной версии. Использование этого пакета SDK в рабочей среде не поддерживается.

Чтобы вызвать бета-версию API, необходимо установить пакет SDK бета-версии Microsoft Graph для Go .

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

См. также

Пакеты SDK в предварительной версии или состояние общедоступной версии.