teamsApp を更新する
名前空間: microsoft.graph
以前にMicrosoft Teams アプリ カタログに発行したアプリを更新します。 アプリを更新するには、アプリの distributionMethod プロパティを organization に設定する必要があります。
この API は、organizationのアプリ カタログ (テナント アプリ カタログ) に発行されたアプリを特に更新します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
- この API を呼び出すことができるのは、Teams サービス管理者またはより高い特権ロールのみです。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | AppCatalog.Submit | AppCatalog.ReadWrite.All,Directory.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
注:
- Directory.ReadWrite.All アクセス許可は、下位互換性のためにのみサポートされます。 前の表に記載されている別のアクセス許可を使用するようにソリューションを更新し、今後これらのアクセス許可を使用しないようにすることをお勧めします。
HTTP 要求
POST /appCatalogs/teamsApps/{id}/appDefinitions
クエリ パラメーター
| プロパティ | 型 | 説明 |
|---|---|---|
| requiresReview | ブール型 | このオプションのクエリ パラメーターは、アプリ レビュー プロセスをトリガーします。 管理者特権を持つユーザーは、レビューをトリガーせずにアプリを送信できます。 ユーザーが発行前にレビューを要求する場合は、 requiresReview を true に設定する必要があります。 管理者特権を持つユーザーは、 requiresReview を設定しないか、値を false に設定することを選択でき、アプリが承認され、すぐに発行されます。 |
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/zip。 必須です。 |
要求本文
要求本文に、Teams zip マニフェスト ペイロードを含めます。 詳細については、「 アプリ パッケージの作成」を参照してください。
手記：[公開されたアプリの一覧表示] 呼び出しから返された ID を使用して、更新するアプリを参照します。 zip アプリ パッケージのマニフェストの ID は使用しないでください。
応答
成功した場合、このメソッドは 204 No Content 応答コードを返します。
例
例 1: 以前にMicrosoft Teams アプリ カタログに発行されたアプリケーションを更新する
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8/appDefinitions
Content-type: application/zip
app.zip
Teams アプリケーションの zip ファイルの詳細については、「 アプリ パッケージの作成」を参照してください。
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content
例 2: 現在のテナント カタログに公開する前に、管理者レビューのために既存のアプリの新しいバージョンを更新する
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions?requiresReview=true
Content-type: application/zip
app.zip
応答
成功した場合、このメソッドは 201 Created 応答コードと、応答本文に "publishingState": "submitted" キーと値のペアを返します。 詳細については、「 teamsAppDefinition」を参照してください。
HTTP/1.1 201 Created
Location: https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions/MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$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"
}