フィードバック 編集

teamsApp の発行

  • [アーティクル]

名前空間: microsoft.graph

重要

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

アプリをアプリ カタログMicrosoft Teams発行します。 具体的には、この API は、組織のカタログ (テナント アプリ カタログ) にアプリを発行します。作成されたリソースの distributionMethod プロパティの値 organizationは .

requiresReview プロパティ を使用すると、管理者がレビューのためにアプリを提出できます。 管理者は、この API または管理者センターからこれらのアプリを承認または拒否Microsoft Teamsできます。

アクセス許可

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

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

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

HTTP 要求

POST /appCatalogs/teamsApps

レビューが必要なアプリを発行するには、次の操作を行います。

POST /appCatalogs/teamsApps?requiresReview:{Boolean}

クエリ パラメーター

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

要求ヘッダー

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

要求本文

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

アプリ カタログ内の各アプリには、一意のマニフェストが必要です id。

応答

成功した場合、このメソッドは応答コードと 200 OK teamsApp オブジェクトを返 します。

例

例 1: アプリ カタログにアプリを発行する

要求

POST https://graph.microsoft.com/beta/appCatalogs/teamsApps
Content-type: application/zip

[Zip file containing a Teams app package]

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

応答

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

例 2: アップロードのアプリ カタログにレビュー用の新しいアプリケーションを作成する

要求

POST https://graph.microsoft.com/beta/appCatalogs/teamsApps?requiresReview=true
Content-type: application/zip

応答

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/beta/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#appCatalogs/teamsApps/$entity",
  "id": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
  "externalId": "b5561ec9-8cab-4aa3-8aa2-d8d7172e4311",
  "name": "Test App",
  "version": "1.0.0",
  "distributionMethod": "organization"
}

例 3: アプリの保留中のレビューを承認または拒否する

要求

HTTP

PATCH https://graph.microsoft.com/beta/appCatalogs/teamsApps/a761ad07-22ef-4a53-9feb-2837c8ad4a84/appDefinitions/YTc2MWFkMDctMjJlZi00YTUzLTlmZWItMjgzN2M4YWQ0YTg0IyMxLjEuOCMjU3VibWl0dGVk
Content-type: application/json
If-Match: InFtSStsNVJHVWdzWUJRU2ZVWGp4RWc9PSI=

{
  "publishingState":"published"
}

応答

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#appCatalogs/teamsApps('a761ad07-22ef-4a53-9feb-2837c8ad4a84')/appDefinitions/$entity",
    "id": "YTc2MWFkMDctMjJlZi00YTUzLTlmZWItMjgzN2M4YWQ0YTg0IyMxLjEuOCMjUHVibGlzaGVk",
    "teamsAppId": "a761ad07-22ef-4a53-9feb-2837c8ad4a84",
    "azureADAppId": null,
    "displayName": "Ducks",
    "version": "1.1.8",
    "requiredResourceSpecificApplicationPermissions": [],
    "publishingState": "published",
    "shortdescription": "quaerat quasi magnam. slight change. 5",
    "description": "Aliquid placeat animi debitis accusamus. Non perferendis ullam. Quis est consequuntur vitae provident. Sunt laudantium id aut. slight change 5",
    "lastModifiedDateTime": null,
    "createdBy": null
}