Получение команды

Статья
03/15/2022
Чтение занимает 3 мин

Пространство имен: microsoft.graph

Важно!

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

Получение свойств и связей указанной команды.

Разрешения

Для вызова этого API требуется одно из указанных ниже разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All , Group.ReadWrite.All, Directory.Read.All , Directory.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Application	TeamSettings.Read.Group , TeamSettings.ReadWrite.Group, Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All , Group.ReadWrite.All, Directory.Read.All , Directory.ReadWrite.All

Примечание.

Разрешения, отмеченные *, используют согласие для конкретного ресурса.

Разрешения, отмеченные ** поддерживаются только для обратной совместимости. Рекомендуется обновить решения, чтобы использовать другое разрешение, указанное в предыдущей таблице, и избегать использования этих разрешений в будущем.

Примечание. Этот API поддерживает разрешения администратора. Глобальные администраторы и администраторы службы Microsoft Teams могут получать доступ к командам, в которых они не состоят.

HTTP-запрос

GET /teams/{team-id}

Необязательные параметры запросов

Этот метод поддерживает параметры запросов OData $select и $expand для настройки отклика.

Заголовки запросов

Заголовок	Значение
Авторизация	Bearer {token}. Обязательный.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

При успешном выполнении этот метод возвращает код отклика 200 OK и объект team в тексте отклика.

Пример

Запрос

Ниже приведен пример запроса.

GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var team = await graphClient.Teams["{team-id}"]
    .Request()
    .GetAsync();

Важно!

Пакеты SDK microsoft Graph используют версию API версии 1.0 по умолчанию и не поддерживают все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к API бета-версии с помощью пакета SDK см. в статье "Использование пакетов SDK Graph Майкрософт с API бета-версии".

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.


const options = {
    authProvider,
};

const client = Client.init(options);

let team = await client.api('/teams/893075dd-2487-4122-925f-022c42e20265')
    .version('beta')
    .get();

Важно!


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/teams/893075dd-2487-4122-925f-022c42e20265"]]];
[urlRequest setHTTPMethod:@"GET"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        MSGraphTeam *team = [[MSGraphTeam alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

Важно!


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

Team team = graphClient.teams("893075dd-2487-4122-925f-022c42e20265")
    .buildRequest()
    .get();

Важно!


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

teamId := "team-id"
result, err := graphClient.TeamsById(&teamId).Get()

Важно!


Import-Module Microsoft.Graph.Teams

Get-MgTeam -TeamId $teamId

Важно!

Отклик

Ниже приведен пример ответа.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "isMembershipLimitedToOwners": true,
  "isArchived": false,
  "memberSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true,
    "allowAddRemoveApps": true,
    "allowCreateUpdateRemoveTabs": true,
    "allowCreateUpdateRemoveConnectors": true
  },
  "guestSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true,
    "allowOwnerDeleteMessages": true,
    "allowTeamMentions": true,
    "allowChannelMentions": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict",
    "allowStickersAndMemes": true,
    "allowCustomMemes": true
  },
  "discoverySettings": {
    "showInTeamsSearchAndSuggestions": true
  },
  "summary": {
    "ownersCount": 2,
    "membersCount": 3,
    "guestsCount": 4,
  }
}

Получение команды

Разрешения

HTTP-запрос

Необязательные параметры запросов

Заголовки запросов

Текст запроса

Отклик

Пример

Запрос

Отклик

Обратная связь