Перечисление всех команд в Microsoft Teams для организации

Чтобы перечислить все команды в организации (клиенте), найдите все группы с командами, а затем получите сведения для каждой команды.

Получение списка групп

Чтобы получить список всех групп в организации, содержащих команды, получите список всех групп и затем в коде найдите нужные, имеющие свойство resourceProvisioningOptions со значением "Team". Так как группы являются большими объектами, используйте аргумент $select, чтобы получить только нужные свойства группы.

GET /groups?$select=id,resourceProvisioningOptions

Примечание. У некоторых неиспользуемых старых групп отсутствует присвоенное свойство resourceProvisioningOptions. Дополнительные сведения см. в статье Известные проблемы.

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

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups",
    "value": [
        {
            "id": "00e897b1-70ba-4cb9-9126-fd5f95c4bb78",
            "resourceProvisioningOptions": []
        },
        {
            "id": "00f6e045-f884-4359-a617-d459ee626862",
            "resourceProvisioningOptions": [
                "Team"
            ]
        }
    ]
}

Получение списка групп с помощью бета-версий интерфейсов API

С помощью бета-версий интерфейсов API можно использовать аргумент $filter для возврата только групп, содержащих команды.

GET /groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team')

Примечание. Фильтрация групп по свойству resourceProvisioningOptions доступна только в конечной точке бета-версии. Свойство resourceProvisioningOptions доступно в версии 1.0 и бета-версии.

Примечание. Некоторые неиспользуемые старые команды не указываются в списке. Дополнительные сведения см. в статье Известные проблемы.

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

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups",
    "value": [
        {
            "id": "02bd9fd6-8f93-4758-87c3-1fb73740a315",
            "description": "Welcome to the HR Taskforce team.",
            "displayName": "HR Taskforce",
            "groupTypes": [
                "Unified"
            ],
            "mailEnabled": true,
            "mailNickname": "HRTaskforce",
            "resourceBehaviorOptions": [],
            "resourceProvisioningOptions": [
                "Team"
            ],
            "securityEnabled": false,
            "visibility": "Private"
        },
        {
            "id": "8090c93e-ba7c-433e-9f39-08c7ba07c0b3",
            "description": "Welcome to the team that we've assembled to launch our product.",
            "displayName": "X1050 Launch Team",
            "groupTypes": [
                "Unified"
            ],
            "mailEnabled": true,
            "mailNickname": "X1050LaunchTeam",
            "resourceBehaviorOptions": [],
            "resourceProvisioningOptions": [
                "Team"
            ],
            "securityEnabled": false,
            "visibility": "Private"
        }
    ]
}

Получение сведений о команде для группы

Чтобы получить сведения о команде в определенной группе, вызовите API get team и включите идентификатор группы.

GET /teams/{group-id}

Ниже показан пример отклика.

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

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

{
  "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
  }
}

См. также