組織の Microsoft Teams 内のすべてのチームのリストを作成するList all teams in Microsoft Teams for an organization

組織 (テナント) 内のすべてのチームのリストを作成するには、チームを所有するグループをすべて割り出し、各チームの情報を取得します。To list all teams in an organization (tenant), you find all groups that have teams, and then get information for each team.

グループのリストを取得するGets a list of groups.

組織内の、チームを所有するすべてのグループのリストを取得するには、すべてのグループのリストを取得し、その中から "Team" を含む resourceProvisioningOptions プロパティを持つグループをプログラムで検索します。To get a list of all groups in the organization that have teams, get a list of all groups and then in code find the ones that have a resourceProvisioningOptions property that contains "Team". グループはサイズの大きいオブジェクトであるため、$select のみを使用して対象のグループのプロパティを取得します。Since groups are large objects, use $select to only get the properties of the group you care about.

GET /groups?$select=id,resourceProvisioningOptions

: 使用されていない古いチームには、resourceProvisioningOptions が設定されていないチームがあります。Note: Certain unused old teams will not have resourceProvisioningOptions set. 詳細については、「既知の問題」を参照してください。For details, see known issues.

応答の例を次に示します。The following is an example of the response.

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

{
    "@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 を使用してグループのリストを取得するGet a list of groups using beta APIs

ベータ版の API を使用すると、$filter を使用して、チームを所有するグループのみ返すことができるようになります。Using the beta APIs, you can use $filter to return only the groups that have teams.

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

Note: /groups に対して $filter を使用できるのは、ベータ版エンドポイントのみとなります。Note: $filter on /groups is only available through the beta endpoint. resourceProvisioningOptions は、v1.0 とベータ版で利用可能です。resourceProvisioningOptions is available in v1.0 and beta.

: 使用されていない古いチームの一部は、リストに含まれません。Note: Certain unused old teams will not be listed. 詳細については、「既知の問題」を参照してください。For details, see known issues.

応答の例を次に示します。The following is an example of the response.

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。Note: The response object shown here might be shortened for readability. 実際の呼び出しではすべてのプロパティが返されます。All the properties will be returned from an actual call.

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

{
    "@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",
        }
    ]
}

グループのチームの情報を入手するGet team information for a group

特定のグループ内のチームの情報を取得するには、get team API を呼び出し、グループ ID を指定します。To get team information for the team in a particular group, call the get team API and include the group ID.

GET /teams/{group-id}

次の例は応答を示しています。The following example shows the response.

注: 読みやすくするために、ここに示す応答オブジェクトは短くされている場合があります。実際の呼び出しからは、すべてのプロパティが返されます。Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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

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

関連項目See also