組織のアプリカタログにアプリを発行するPublish apps to your organization's app catalog

Microsoft Teams アプリカタログにアプリを発行します。Publish an app to the Microsoft Teams apps catalog. 具体的には、この API は、アプリを組織のカタログ (テナントのアプリカタログ) に公開します。作成されたリソースdistributionMethod = organizationには、があります。Specifically, this API publishes the app to your organization's catalog (the tenant app catalog); the created resource will have distributionMethod = organization.

アクセス許可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

POST /appCatalogs/teamsApps

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type アプリケーション/zipapplication/zip

要求本文Request body

Teams の Zip マニフェストのペイロード。Teams Zip Manifest Payload. Teams アプリケーションの zip ファイルについては、「アプリパッケージを作成する」を参照してくださいFor Teams application zip file see Create an app package. その組織の別のアプリと同じマニフェスト ID を持つ組織に対してアプリを作成することはできません。You can't create an app for an organization that has the same manifest ID as another app in that organization.

応答Response

成功した場合、このメソッド200 OKは応答コードと、 teamsCatalogAppオブジェクトを返します。If successful, this method returns a 200 OK response code and a teamsCatalogApp object.

Example

要求Request

POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps
Content-type: application/zip
Content-length: 244

[Zip file containing a Teams app package]

Microsoft Teams アプリケーション zip ファイルを作成する方法については、「アプリパッケージを作成する」を参照してください。For information about how to create a Microsoft Teams application zip file, see Create an app package.

応答Response

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
  "externalId": "b5561ec9-8cab-4aa3-8aa2-d8d7172e4311",
  "name": "Test App",
  "version": "1.0.0",
  "distributionMethod": "organization"
}