フィードバック 編集

teamsApp の更新

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

以前にアプリ カタログに発行されたアプリMicrosoft Teams更新します。 アプリを更新するには、 アプリの distributionMethod プロパティをに設定する必要があります organization。

この API は、組織のアプリ カタログ (テナント アプリ カタログ) に発行されたアプリを具体的に更新します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

注: この API を呼び出すのは、グローバル管理者のみです。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) AppCatalog.Submit, AppCatalog.ReadWrite.All, Directory.ReadWrite.All**
委任 (個人用 Microsoft アカウント) サポートされていません
アプリケーション サポートされていません。

注: ** でマークされたアクセス許可は、下位互換性のためにのみサポートされています。 ソリューションを更新して、前の表に示した別のアクセス許可を使用し、今後これらのアクセス許可を使用しないようにすることをお勧めします。

HTTP 要求

POST /appCatalogs/teamsApps/{id}/appDefinitions

クエリ パラメーター

プロパティ 種類 説明
requiresReview ブール型 このオプションのクエリ パラメーターは、アプリレビュー プロセスをトリガーします。 管理者特権を持つユーザーは、レビューをトリガーせずにアプリを送信できます。 ユーザーが発行前にレビューを要求する場合は、 に設定する必要 requiresReview があります true。 管理者特権を持つrequiresReview``falseユーザーは、値を設定または設定しない場合、アプリは承認済みと見なされ、即座に公開されます。

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。必須。
Content-Type application/zip。 必須です。

要求本文

要求本文に、zip マニフェスト ペイロードTeams含める。 詳細については、「アプリ パッケージの 作成」を参照してください。

注: 更新するアプリを参照するには、 発行 済みアプリのリスト呼び出しから返される ID を使用します。 zip アプリ パッケージのマニフェストの ID を使用しない。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。

例

例 1: 以前にアプリ カタログに発行されたアプリケーションMicrosoft Teams更新する

要求

POST https://graph.microsoft.com/beta/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8/appDefinitions
Content-type: application/zip

[Zip file containing a Teams app package]

アプリケーション zip ファイルTeams詳細については、「アプリ パッケージの作成」を参照してください。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。

例 2: 現在のテナント カタログに公開する前に、管理者レビュー用に既存のアプリの新しいバージョンを更新する

要求

POST https://graph.microsoft.com/beta/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions?requiresReview=true
Content-type: application/zip

[Zip file containing a Teams app package]

応答

成功した場合、このメソッドは応答コード 201 Created とキー/ publishingState値のペア : を submitted 応答本文で返します。 teamsappdefinition を参照してください。

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/beta/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions/MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#appDefinition",
    "@odata.etag": "158749010",
    "id": "MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==",
    "teamsAppId": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
    "displayName": "Test app",
    "version": "1.0.11",
    "azureADAppId": "a651cc7d-ec54-4fb2-9d0e-2c58dc830b0b",
    "requiredResourceSpecificApplicationPermissions":[
         "ChannelMessage.Read.Group",
         "Channel.Create.Group",
         "Tab.ReadWrite.Group",
         "Member.Read.Group"
    ],
    "publishingState": "submitted",
    "lastModifiedDateTime": "2020-02-10 22:48:33.841",
}