Microsoft Teams アプリカタログから発行されたアプリを一覧表示するList the published apps from the Microsoft Teams app catalog

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

Microsoft Teams アプリカタログのアプリを一覧表示します。List apps from the Microsoft Teams app catalog. これには、Microsoft Teams ストアからのアプリや、組織のアプリカタログ (テナントのアプリカタログ) からのアプリが含まれます。This includes apps from the Microsoft Teams store, as well as apps from your organization's app catalog (the tenant app catalog). 組織のアプリカタログからアプリのみを取得するにはOrganizationteamsCatalogAppリソースの "の" として、を指定します。 ****To get apps from your organization's app catalog only, specify Organization as the distributionMethod in the teamsCatalogApp resource.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

注: この API は、グローバル管理者のみが呼び出すことができます。Note: Only global administrators can call this API.

アクセス許可の種類Permission Type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) AppCatalog.ReadWrite.AllAppCatalog.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていませんNot supported
アプリケーションApplication 非サポートNot supported

HTTP 要求HTTP request

GET /appCatalogs/teamsApps

オプションのクエリ パラメーターOptional query parameters

このメソッドは、応答をカスタマイズするための $filter、$select、および $expand OData クエリ パラメーターをサポートします。This method supports the $filter, $select, and $expand OData query parameters to help customize the response.

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.

要求本文Request body

なし。None.

注:TeamsCatalogAppオブジェクトの任意のフィールドでフィルター処理して、結果の一覧を短縮できます。Note: You can filter on any of the fields of the teamsCatalogApp object to shorten the list of results. 次のいずれかのフィルター操作を使用できます: Equal、not equal、and、or not。You can use any of the following filter operations: Equal, not-equal, and, or, and not.

応答Response

成功した場合、このメソッド200 OKは応答コードと、応答本文でteamsCatalogAppオブジェクトのリストを返します。If successful, this method returns a 200 OK response code and a list of teamsCatalogApp objects in the response body.

Examples

例 1: すべてのアプリケーションを一覧表示するExample 1: List all applications

次の例では、テナント固有のすべてのアプリケーションを一覧表示します。The following example lists all applications that are specific to your tenant.

要求Request

GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=distributionMethod eq 'organization'

応答Response

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

{
  "value": [
    {
      "id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5",
      "externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
      "name": "Test App",
      "version": "1.0.1",
      "distributionMethod": "Organization"
    }
  ]
}

例 2: 指定された ID を持つアプリケーションを一覧表示するExample 2: List applications with a given ID

次の例では、指定された ID を持つアプリケーションを一覧表示します。The following example lists applications with a given ID.

要求Request

GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=id%20eq%20'b1c5353a-7aca-41b3-830f-27d5218fe0e5'

応答Response

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

{
  "value": [
    {
      "id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5",
      "externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
      "name": "Test App",
      "version": "1.0.1",
      "distributionMethod": "Organization"
    }
  ]
}