TeamsApp を発行する
名前空間: microsoft.graph
アプリをMicrosoft Teams アプリ カタログに発行します。
具体的には、この API はアプリを組織のカタログ (テナント アプリ カタログ) に発行します。作成されたリソースの distributionMethod プロパティ値は、 organizationです。
requiresReview プロパティを使用すると、すべてのユーザーが管理者によるレビューのためにアプリを送信できます。 管理者は、この API または Microsoft Teams 管理センターを使用して、これらのアプリを承認または拒否できます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | AppCatalog.Submit | AppCatalog.ReadWrite.All,Directory.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
注:
Directory.ReadWrite.All アクセス許可は、下位互換性のためにのみサポートされます。 前の表に記載されている別のアクセス許可を使用するようにソリューションを更新し、今後これらのアクセス許可を使用しないようにすることをお勧めします。
HTTP 要求
POST /appCatalogs/teamsApps
レビューを必要とするアプリを発行するには:
POST /appCatalogs/teamsApps?requiresReview={Boolean}
クエリ パラメーター
| プロパティ | 型 | 説明 |
|---|---|---|
| requiresReview | ブール型 | このオプションのクエリ パラメーターは、アプリ レビュー プロセスをトリガーします。 管理者特権を持つユーザーは、レビューをトリガーせずにアプリを送信できます。 ユーザーが発行前にレビューを要求する場合は、 requiresReview を true に設定する必要があります。 管理者特権を持つユーザーは、 requiresReview を設定しないか、値を false に設定することを選択でき、アプリが承認され、すぐに発行されます。 |
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/zip。 必須です。 |
要求本文
要求本文に、Teams zip マニフェスト ペイロードを含めます。 詳細については、「 アプリ パッケージの作成」を参照してください。
アプリ カタログ内の各アプリには、一意のマニフェスト ID が必要です。
応答
成功した場合、このメソッドは 200 OK 応答コードと teamsApp オブジェクトを返します。 アプリ マニフェストに検証エラーがある場合、要求はスキーマ エラーに関する詳細を含むエラー応答を返します。
エラー応答
不足している情報またはエラーを含むアプリ マニフェストをアップロードする要求を送信すると、内部エラー コード UnableToParseTeamsAppManifestを含むエラー メッセージが表示されます。 内部エラーの details プロパティには、エラー コードとエラー メッセージが含まれています。 次の表では、発生する可能性があるエラー コードについて説明します。
エラー応答
| エラー コード | エラー メッセージ | 説明 |
|---|---|---|
Serialization_FileNotValidJson |
ファイルを JSON オブジェクトとして解析できませんでした。 | 送信されたファイルが有効な JSON 形式に準拠していません。 |
Serialization_FileMissing |
{0}ファイルがアプリ パッケージに見つかりませんでした。 | アプリ パッケージに予期されるファイルがありません。 |
Serialization_TrailingCommaInManifestJsonFile |
マニフェスト json ファイルには、末尾のコンマが含まれています。 | アプリ マニフェスト ファイルには、末尾にコンマが含まれています。 |
SchemaError_MultipleOf |
整数 {0} は、 {1}の倍数ではありません。 | アプリ マニフェスト ファイルは、スキーマの multipleOf 検証に失敗しました。 ここで、 {0} は整数値を表し、 {1} は必要な倍数を示します。 |
SchemaError_Maximum |
整数 {0} が {1}の最大値を超えています。 | アプリ マニフェスト ファイルは、スキーマの maximum 検証に失敗しました。 ここで、 {0} は最大値を超える値を表し、 {1} は最大値を表します。 |
SchemaError_Minimum |
整数 {0} は、 {1}の最小値未満です。 | アプリ マニフェスト ファイルは、スキーマの minimum 検証に失敗しました。 ここで、 {0} は最小制限を超える値を表し、 {1} は最小制限を表します。 |
SchemaError_MaximumLength |
文字列 {0} が {1}の最大長を超えています。 | アプリ マニフェスト ファイルは、スキーマの maximumLength 検証に失敗しました。 ここでは、 {0} は最大長を超える文字列を表し、 {1} は最大長を表します。 |
SchemaError_MinimumLength |
文字列 {0} は、 {1}の最小長未満です。 | アプリ マニフェスト ファイルは、スキーマの minimumLength 検証に失敗しました。 ここでは、 {0} は最小長未満の文字列を表し、 {1} は最小値を表します。 |
SchemaError_Pattern |
文字列 {0} が正規表現パターン "{1}" と一致しません。 | アプリ マニフェスト ファイルは、スキーマの pattern 検証に失敗しました。 ここでは、 {0} はパターンと一致しない値を表し、 {1} は予期されるパターンを表します。 |
SchemaError_ContentEncoding |
文字列 {0} は、コンテンツ エンコード {1}に対して検証されません。 | アプリ マニフェスト ファイルは、スキーマの contentEncoding 検証に失敗しました。 ここでは、 {0} はコンテンツ エンコードと一致しない文字列を表し、 {1} は想定されるコンテンツ エンコードを表します。 |
SchemaError_Format |
文字列 {0} は、形式 {1}に対して検証されません。 | アプリ マニフェスト ファイルは、スキーマの format 検証に失敗しました。 ここでは、 {0} は想定される形式ではない文字列を表し、 {1} は想定される形式を表します。 |
SchemaError_Type |
値 {0} は、予期される型の {1}ではありません。 | アプリ マニフェスト ファイルは、スキーマの type 検証に失敗しました。 ここでは、 {0} は想定される型に含まれていない文字列を表し、 {1} は予期される型を表します。 |
SchemaError_AdditionalItems |
スキーマでは、追加の項目は許可されません。 | アプリ マニフェスト ファイルは、スキーマの additionalItems 検証に失敗しました。 |
SchemaError_MaximumItems |
配列項目数{0}{1}の最大数を超えています。 | アプリ マニフェスト ファイルは、スキーマの maximumItems 検証に失敗しました。 ここで、 {0} は配列内の要素の数を表し、 {1} は許可される最大値を表します。 |
SchemaError_MinimumItems |
配列項目数 {0} は、 {1}の最小カウント未満です。 | アプリ マニフェスト ファイルは、スキーマの minimumItems 検証に失敗しました。 ここで、 {0} は配列内の要素の数を表し、 {1} は許可される最小値を表します。 |
SchemaError_UniqueItems |
配列には、一意ではない項目が含まれています。 | アプリ マニフェスト ファイルは、スキーマの uniqueItems 検証に失敗しました。 |
SchemaError_MaximumProperties |
オブジェクト プロパティの数{0}{1}の最大数を超えています。 | アプリ マニフェスト ファイルは、スキーマの maximumProperties 検証に失敗しました。 ここで、 {0} は指定されたプロパティの数を表し、 {1} は許可される最大プロパティを表します。 |
SchemaError_MinimumProperties |
オブジェクト プロパティの数 {0} が、 {1}の最小数未満です。 | アプリ マニフェスト ファイルは、スキーマの minimumProperties 検証に失敗しました。 ここで、 {0} は指定されたプロパティの数を表し、 {1} は許可される最小プロパティを表します。 |
SchemaError_Required |
オブジェクトに必要なプロパティがありません: {0}。 | アプリ マニフェスト ファイルは、スキーマの required 検証に失敗しました。 ここで、 {0} は必要なプロパティを表します。 |
SchemaError_AdditionalProperties |
プロパティ {0} が定義されておらず、スキーマでは追加のプロパティが許可されていません。 | アプリ マニフェスト ファイルは、スキーマの additionalProperties 検証に失敗しました。 ここで、 {0} は追加のプロパティを表します。 |
SchemaError_Dependencies |
プロパティの依存関係 {0} 失敗しました。 必要なキーがありません。 | アプリ マニフェスト ファイルは、スキーマの dependencies 検証に失敗しました。 ここでは、 {0} は失敗したプロパティを表します。 |
SchemaError_Enum |
値 {0} は列挙型で定義されていません。 | アプリ マニフェスト ファイルは、スキーマの enum 検証に失敗しました。 ここでは、 {0} 列挙型にない値を表します。 |
SchemaError_AllOf |
JSON が "allOf" のすべてのスキーマと一致するとは限りません。 | アプリ マニフェスト ファイルは、スキーマの allOf 検証に失敗しました。 |
SchemaError_AnyOf |
JSON が "anyOf" のスキーマと一致しません。 | アプリ マニフェスト ファイルは、スキーマの anyOf 検証に失敗しました。 |
SchemaError_OneOf |
JSON は、"oneOf" からの複数のスキーマに対して有効です。 | アプリ マニフェスト ファイルは、スキーマの oneOf 検証に失敗しました。 |
SchemaError_Not |
JSON は、"not" からのスキーマに対して有効です。 | アプリ マニフェスト ファイルは、スキーマの not 検証に失敗しました。 |
SchemaError_Id |
重複するスキーマ ID {0} 検出されました。 | アプリ マニフェスト ファイルは、スキーマの id 検証に失敗しました。 ここで、 {0} はスキーマの id を表します。 |
SchemaError_PatternProperties |
正規表現パターン "{0}" でプロパティ名をテストできませんでした。 | アプリ マニフェスト ファイルは、スキーマの patternProperties 検証に失敗しました。 ここでは、 {0} プロパティのパターンを表します。 |
SchemaError_Valid |
スキーマは常に検証に失敗します。 | アプリ マニフェスト ファイルは、スキーマの valid 検証に失敗しました。 |
SchemaError_Const |
値 {0} が定数 {1}と一致しません。 | アプリ マニフェスト ファイルは、スキーマの const 検証に失敗しました。 ここでは、 {0} は失敗した値を表し、 {1} は正しい値を表します。 |
SchemaError_Contains |
配列に必要な項目が含まれていない。 | アプリ マニフェスト ファイルは、スキーマの contains 検証に失敗しました。 |
SchemaError_Then |
JSON が "then" からのスキーマと一致しません。 | アプリ マニフェスト ファイルは、スキーマの then 検証に失敗しました。 |
SchemaError_Else |
JSON が "else" のスキーマと一致しません。 | アプリ マニフェスト ファイルは、スキーマの else 検証に失敗しました。 |
SchemaError_Other |
値は、このプロパティのスキーマに準拠していません。 | アプリ マニフェスト ファイルは、スキーマの他の未処理の検証に失敗しました。 |
ActivityGroupIdFromActivitiesTypeValidation |
ActivityType の ActivityGroupId フィールドは、ActivityGroup の ID フィールドのサブセットである必要があります。 |
ActivityTypeのActivityGroupId フィールドは、アプリ マニフェストのActivityGroupのId フィールドのサブセットではありません。 |
ActivityTypesMustExistWithActivitiesGroupValidation |
アクティビティの種類が見つからない場合は、マニフェストにアクティビティ グループを含めてはいけません。 |
ActivityGroup プロパティを使用できますが、ActivityType プロパティがアプリ マニフェストに表示されません。 |
ApiSecretServiceAuthTypeComposeExtensionContainsMsftEntraConfiguration |
apiSecretServiceAuth authType を使用した API ベースの compose 拡張機能には、microsoftEntraConfiguration が定義されています。 | API ベースの compose 拡張機能は、アプリ マニフェストで microsoftEntraConfiguration 定義されています。 |
ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretRegistrationId |
apiSecretServiceAuth authType を使用した API ベースの compose 拡張機能には、apiSecretRegistrationId が定義されていません。 | アプリ マニフェストで定義されていない、 apiSecretServiceAuth authType を使用した API ベースの compose 拡張機能 apiSecretRegistrationId 。 |
ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretServiceAuthConfiguration |
apiSecretServiceAuth authType を使用した API ベースの compose 拡張機能には、apiSecretServiceConfiguration がありません。 | API ベースの compose 拡張機能では、 supportsSingleSignOn がアプリ マニフェストで true に設定されていません。 |
ApiBasedComposeExtensionManifestCommandIdsNotIncludedInOperationIdsOnApiSpecficationFile |
マニフェストのコマンド ID は、API 仕様ファイルの操作 ID には含まれません。 | アプリ マニフェストの Command Ids が API 仕様ファイルの Operation Ids に含まれていない場合に発生するエラー。 |
ApiBasedComposeExtensionWithBotId |
API ベースの compose 拡張機能で botId を定義することはできません。 | API ベースの compose 拡張機能は、アプリ マニフェストで botId 定義されています。 |
ApiBasedComposeExtensionWithCanUpdateConfiguration |
API ベースの compose 拡張機能では、マニフェストで canUpdateConfiguration を定義することはできません。 | API ベースの compose 拡張機能は、アプリ マニフェストで canUpdateConfiguration 定義されています。 |
ApiBasedComposeExtensionWithNoParameter |
API ベースの compose 拡張機能には、マニフェストでコマンド パラメーターが定義されている必要があります。 | API ベースの compose 拡張機能には、アプリ マニフェストで定義されているコマンド パラメーターがありません。 |
ApiBasedComposeExtensionApiResponseRenderingTemplateFileNullOrEmpty |
API ベースの compose 拡張機能には、マニフェストで apiResponseRenderingTemplateFile が定義されている必要があります。 | API ベースの compose 拡張機能には、アプリ マニフェストで apiResponseRenderingTemplateFile が定義されていません。 |
ApiBasedComposeExtensionApiSpecificationFileNullOrEmpty |
API ベースの compose 拡張機能には、マニフェストで apiSpecificationFile が定義されている必要があります。 | API ベースの compose 拡張機能には、アプリ マニフェストで apiSpecificationFile が定義されていません。 |
MsftEntraAuthTypeComposeExtensionContainsApiSecretServiceConfiguration |
microsoftEntra authType を使用した API ベースの compose 拡張機能には、apiSecretServiceConfiguration が定義されています。 | API ベースの compose 拡張機能は、マニフェストで apiSecretServiceConfiguration 定義されています。 |
MsftEntraAuthTypeComposeExtensionContainsNoMsftEntraConfiguration |
microsoftEntra authType を使用した API ベースの compose 拡張機能には、microsoftEntraConfiguration が定義されていません。 | API ベースの compose 拡張機能には、アプリ マニフェストで microsoftEntraConfiguration が定義されていません。 |
MsftEntraAuthTypeComposeExtensionWebApplicationInfoOrResourceNotDefined |
microsoftEntra authType を使用した API ベースの compose 拡張機能には、マニフェストで webApplicationInfo またはリソースが定義されていません。 |
microsoftEntra authType を使用する API ベースの compose 拡張機能には、アプリ マニフェストでwebApplicationInfoまたはresourceが定義されていません。 |
MsftEntraAuthTypeComposeExtensionResourceURLNotMatchServerURLOnApiSpec |
マニフェストの microsoftEntra authType リソース URL を使用した API ベースの compose 拡張機能が、API 仕様ファイルのサーバー URL と一致しません。 | アプリ マニフェストの microsoftEntra authType リソース URL を持つ API ベースの compose 拡張機能が、API 仕様ファイルのサーバー URL と一致しません。 |
NoAuthTypeComposeExtensionContainsAuthConfiguration |
authType に認証関連の構成が定義されていない API ベースの compose 拡張機能。 | authType microsoftEntraConfiguration または apiSecretServiceConfiguration を使用した API ベースの compose 拡張機能は、アプリ マニフェストでは定義されていません。 |
ApiSpecificationFileContainUnsupportedHttpMethod |
API ベースの compose 拡張機能には、apiSpecificationFile でサポートされていない http メソッドが定義されているサーバー URL があります。 現在、GET と POST のみがサポートされています。 | API ベースの compose 拡張機能には、apiSpecificationFileで定義されているサポートされていないhttp メソッドがあります。 |
ApiSpecificationFileRequiredParameterContainUnsupportedLocation |
API ベースの compose 拡張機能には、 {0}の apiSpecificationFile で定義されているサポートされていないパラメーターの場所があります。 現在サポートされているのは、パスとクエリのみです。 | API ベースの compose 拡張機能には、 apiSpecificationFileで定義されているサポートされていないパラメーターの場所があります。 |
ApiSpecificationFileRequestBodyContainUnsupportedMediaType |
API ベースの compose 拡張機能には、apiSpecificationFile の要求本文で定義されているサポートされていないメディアの種類があります。 現在、サポートされているのは application/json のみです。 | API ベースの compose 拡張機能には、apiSpecificationFileの要求本文で定義されているサポートされていないmedia型があります。 |
ApiSpecificationFileRequestBodyContainUnsupportedSchemaType |
API ベースの compose 拡張機能には、apiSpecificationFile の要求本文で定義されているスキーマの種類がサポートされていません。 現在、配列はサポートされていません。 | API ベースの compose 拡張機能には、 apiSpecificationFileの要求本文で定義されているサポートされていないスキーマの種類があります。 |
ApiSpecificationFileRequestBodySchemaContainKeywords |
API ベースの compose 拡張機能にはキーワードがあります。 | API ベースの compose 拡張機能には、 apiSpecificationFileの要求本文で定義されたキーワードがあります。 |
ApiSpecificationFileRequiredParameterOrPropertyNotDefinedOnManifest |
API ベースの compose 拡張機能には、マニフェストで定義されていない {0} 必要なパラメーターまたはプロパティがあります。 | API ベースの compose 拡張機能には、アプリ マニフェストで定義されていない required パラメーターがあります。 |
ApiSpecificationFileResponseContainUnsupportedMediaType |
API ベースの compose 拡張機能には、apiSpecificationFile に対する応答でサポートされていないメディアの種類が定義されています。 現在、サポートされているのは application/json のみです。 | API ベースの compose 拡張機能には、サポートされていない media 型が apiSpecificationFileの応答で定義されています。 |
ApiSpecificationFileServerUrlsContainHttp |
API ベースの compose 拡張機能には、apiSpecificationFile で http プロトコルが定義されているサーバー URL があります。 | API ベースの compose 拡張機能には、apiSpecificationFileにhttp プロトコルを含むサーバー URL があります。 |
ApiSpecificationFileServerUrlsContainInvalidUrl |
API ベースの compose 拡張機能には、apiSpecificationFile で定義されている無効な URL であるサーバー URL があります。 | API ベースの compose 拡張機能には、apiSpecificationFileで定義されたinvalid URL があります。 |
ServerUrlsMissingOnApiSpecificationFile |
API ベースの compose 拡張機能には、apiSpecificationFile で定義されたサーバー URL がありません。 | 発生するエラー API ベースの compose 拡張機能には、 apiSpecificationFileでサーバー URL が定義されていません。 |
BotBasedComposeExtensionApiResponseRenderingTemplateFileExists |
ボット ベースの compose 拡張機能では、apiResponseRenderingTemplateFile を定義できません。 | ボット ベースの compose 拡張機能には、アプリ マニフェストで apiResponseRenderingTemplateFile プロパティが定義されています。 |
BotBasedComposeExtensionApiSpecificationFileExists |
ボット ベースの compose 拡張機能で apiSpecificationFile を定義することはできません。 | ボットベースの compose 拡張機能には、アプリ マニフェストで定義された API 仕様ファイルがあります。 |
BotBasedComposeExtensionBotIdNotGuid |
ボット ベースの compose 拡張機能には GUID botId が必要です。 | ボットベースの compose 拡張機能 botId GUID ではありません。 |
CommonAppIdIsNotGuid |
フィールド 'ID' はマニフェストの Guid ではありません。 |
appIdは GUID ではありません。 |
CommonAppIdIsRequiredField |
マニフェストに必須フィールド 'ID' がありません。 |
appIdは提供されていません。 |
CommonManifestVersionIsRequiredField |
マニフェスト 'manifest Version' の必須フィールドがありません。 | マニフェストのバージョンは提供されていません。 |
CommonSchemaUrlIsRequiredField |
スキーマ URL が存在する必要があります。 | スキーマは指定されていません。 |
DashboardCardBothIconNameAndUrlPresent |
ダッシュボード カード アイコンには、アイコン名と URL の両方を含めることはできません。 | ダッシュボード カード アイコンには、アイコン名と URL の両方を含めることはできません。 |
DashboardCardEntityIdsAreNotUnique |
ダッシュボード カード エンティティ ID は一意である必要があります。 | ダッシュボード カードの返されるエンティティ ID は、マニフェスト内で一意ではありません。 |
DeveloperNameIsRequiredField |
マニフェストに必須フィールド 'developer name' がありません。 | 開発者名は指定されていません。 |
DeveloperNameLengthCheck |
最大文字数は 32 文字を超えてはなりません。 | 開発者名の長さは 32 文字を超えています。 |
DeveloperPrivacyUrlIsRequiredField |
必須フィールド 'privacyUrl' がマニフェストにありません。 | アプリ マニフェストに privacyUrl がありません。 |
DeveloperPrivacyUrlMustBeHttps |
プライバシー URL はセキュリティ保護されたサポート URL (HTTPS) である必要があります。 | 開発者のプライバシー URL で HTTPS が使用されませんでした。 |
DeveloperTermsOfUseUrlIsRequiredField |
必須フィールド 'termsOfUseUrl' がマニフェストにありません。 | マニフェストに termsOfUseUrl がありません。 |
DeveloperTermsOfUseUrlMustBeHttps |
使用条件 URL は、セキュリティで保護されたサポート URL (HTTPS) である必要があります。 | 開発者の使用条件 URL で HTTPS が使用されませんでした。 |
DeveloperWebsiteUrlIsRequiredField |
マニフェストに必須フィールド 'websiteUrl' がありません。 | 開発者 Web サイトの URL がありません。 |
DeveloperWebsiteUrlMustBeHttps |
Web サイト URL はセキュリティ保護されたサポート URL (HTTPS) である必要があります。 | 開発者 Web サイトの URL で HTTPS が使用されませんでした。 |
UniqueActivityTypeInActivitiesValidation |
マニフェストに重複するアクティビティの種類を含めてはいけません。 | アクティビティの種類は、アプリ マニフェストで一意ではありません。 |
UniqueIdInActivitiesGroupValidation |
マニフェストには、アクティビティ グループに重複する ID を含めてはいけません。 | アクティビティ グループ ID は、アプリ マニフェストで一意ではありません。 |
FullDescriptionCannotBeEmpty |
完全な説明を空にすることはできません。 | 完全な説明は空です。 |
FullDescriptionLengthCheck |
長い説明の最大文字数は、4,000 文字を超えてはなりません。 | 完全な説明の長さは 4,000 文字を超えています。 |
GroupChatForBotsLessThanV13 |
マニフェスト v1.3 以降ではグループ チャット ボットがサポートされているため、マニフェストのバージョンを V1.3 にアップグレードしてください。 | ボットの groupChat スコープは、アプリ マニフェスト バージョン 1.3 以降ではサポートされていません。 |
GroupChatForConfigurableTabsLessThanV13 |
マニフェスト v1.3 以降ではグループ チャット構成可能タブがサポートされているため、マニフェストのバージョンを V1.3 にアップグレードしてください。 | 構成可能なタブの groupChat スコープは、アプリ マニフェスト バージョン 1.3 以降ではサポートされていません。 |
InvalidColor32x32IconHeightAndWidth |
色 32x32 アイコンは、白と透明のみで 32x32 にする必要があります。 | 色 32x32 アイコンに正しいサイズがありません。 |
InvalidColorIconHeightAndWidth |
色アイコンは、必要なディメンションに従っていません。 | 色アイコンのサイズが正しくありません。 |
InvalidOutlineIconHeightAndWidth |
小さいアイコンは、白と透明の 32 x 32 にする必要があります。 | アウトライン アイコンのサイズが正しくありません。 |
ParameterOnManifestNotDefinedOnApiSpecFile |
API ベースの compose 拡張機能には、API 仕様ファイルで定義されていないマニフェストに {0} パラメーターがあります。 | アプリ マニフェストの API ベースの compose 拡張パラメーターは、API 仕様ファイルでは定義されていません。 |
ReservedActivitiesValidation |
マニフェストには、予約されたアクティビティの種類 'systemDefault' を含めてはいけません。 |
systemDefault アクティビティの種類は、アプリ マニフェストで定義されます。 |
ReservedStaticTabNameShouldBeNull |
予約済みタブの [名前] プロパティを指定しないでください。 | 予約 staticTabs name プロパティが指定されました。 |
ShortDescriptionCannotBeEmpty |
短い説明を空にすることはできません | 簡単な説明は空でした。 |
ShortDescriptionLengthCheck |
短い説明の最大文字数は、80 文字を超えてはなりません。 | 短い説明は 80 文字を超えています。 |
ShortNameEqualsReservedName |
アプリの短い名前を予約名にすることはできません。 | 短い名前は予約済み名です。 |
ShortNameIsRequiredField |
アプリの短い名前を空にすることはできません。 | 短い名前は空です。 |
StaticTabNameCouldNotBeEmpty |
予約されていない staticTabs "Name" プロパティを空にすることはできません。 |
staticTabs name プロパティが空です。 |
BotIdIsNotGuid |
BotId は Guid 値ではありません。 | アプリ マニフェストの BotId 値は GUID ではありません。 |
VersionCannotBeEmpty |
マニフェストに必須フィールド "version" がありません。 | アプリ パッケージのバージョンがありません。 |
VersionContainsOnlyNumbersDotSeparated |
アプリのバージョンでは、'#.#.#' 形式の数値のみがサポートされます。 | アプリ パッケージ内のバージョンは、パターン ( #.#.#) と一致しません。 |
VersionHasMajorLessThan1 |
アプリのバージョンが '0' で始まるべきではありません。 例: 0.0.1 または 0.1 は有効なアプリ バージョンではなく、1.0 / 1.5.1 / 1.0.0 / 2.5.0 は有効なアプリ バージョンです。 マニフェストでストア内の既存のアプリに対する新しい更新の場合。 | アプリのバージョンが 1.0 未満です。 アプリのバージョンをアップグレードする必要があります。 たとえば、ストア内のアプリの現在のバージョンが 1.0 で、検証用の更新プログラムを提出する場合、アプリのバージョンは 1.0 を超える必要があります。 |
ShortNameLengthCheck |
短い名前の最大文字数は 30 文字を超えることはできません。 | 短い名前は 30 文字を超えています。 |
ApiSpecificationFileParameterContainUnsupportedSchemaType |
API ベースの compose 拡張機能には、apiSpecificationFile.Arrays で定義されているサポートされていないパラメーター スキーマ型があります。サポートされていません。 | API ベースの compose 拡張機能には、 apiSpecificationFileで定義されているサポートされていないパラメーター スキーマ型があります。 |
例
例 1: アプリ カタログにアプリを発行する
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps
Content-type: application/zip
[Zip file containing a Teams app package]
Microsoft Teams アプリケーションの zip ファイルを作成する方法については、「 アプリ パッケージの作成」を参照してください。
応答
次の例は応答を示しています。
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
"externalId": "b5561ec9-8cab-4aa3-8aa2-d8d7172e4311",
"displayName": "Test App",
"distributionMethod": "organization"
}
例 2: レビュー用の新しいアプリケーションを組織のアプリ カタログにアップロードする
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?requiresReview=true
Content-type: application/zip
応答
次の例は応答を示しています。
HTTP/1.1 201 Created
Location: https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#appCatalogs/teamsApps/$entity",
"id": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
"externalId": "b5561ec9-8cab-4aa3-8aa2-d8d7172e4311",
"displayName": "Test App",
"distributionMethod": "organization"
}
例 3: アプリのレビュー待ちを承認または拒否する
要求
次の例は要求を示しています。
PATCH https://graph.microsoft.com/v1.0/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/v1.0/$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
}
例 4: アプリ マニフェストでエラーが発生してアプリ カタログにアプリを発行する
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps
Content-type: application/zip
[Zip file containing a Teams app package]
応答
次の例は応答を示しています。
HTTP/1.1 200 OK
Content-type: application/json
{
"error": {
"code": "BadRequest",
"message": "name | Required properties are missing from object: [].; developer.websiteUrl | String \"hs://www.yo.com\" does not match regex pattern \"^[Hh][Tt][Tt][Pp][Ss]?://\".",
"innerError": {
"code": "UnableToParseTeamsAppManifest",
"message": "name | Required properties are missing from object: [].; developer.websiteUrl | String \"hs://www.yo.com\" does not match regex pattern \"^[Hh][Tt][Tt][Pp][Ss]?://\".",
"details": [
{
"code": "SchemaError_Required",
"message": "Required properties are missing from object: [].",
"target": "name"
},
{
"code": "SchemaError_Pattern",
"message": "String \"hs://www.yo.com\" does not match regex pattern \"^[Hh][Tt][Tt][Pp][Ss]?://\".",
"target": "developer.websiteUrl"
}
],
"date": "2024-01-18T21:47:58",
"request-id": "d1878136-bc88-421a-b342-c3d883db31a1",
"client-request-id": "d1878136-bc88-421a-b342-c3d883db31a1"
}
}
}