TeamsApp を発行する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
アプリをMicrosoft Teams アプリ カタログに発行します。
具体的には、この API はアプリをorganizationのカタログ (テナント アプリ カタログ) に発行します。作成されたリソースの distributionMethod プロパティ値はorganization。
requiresReview プロパティを使用すると、すべてのユーザーが管理者によるレビューのためにアプリを送信できます。 管理者は、この API または Microsoft Teams 管理センターを使用して、これらのアプリを承認または拒否できます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | AppCatalog.Submit | AppCatalog.ReadWrite.All,Directory.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
注:
-
Directory.ReadWrite.Allアクセス許可は、下位互換性のためにのみサポートされます。 前の表に記載されている別のアクセス許可を使用するようにソリューションを更新し、今後これらのアクセス許可を使用しないようにすることをお勧めします。 -
AppCatalog.Submitアクセス許可を使用すると、アプリをカタログに発行せず、レビュー専用に送信できます。
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 プロパティには、エラー コードとエラー メッセージが含まれています。 次の表では、発生する可能性があるエラー コードについて説明します。
エラー応答
| エラー コード | エラー メッセージ | 説明 |
|---|---|---|
ActivityGroupIdFromActivitiesTypeValidation |
ActivityType の ActivityGroupId フィールドは、ActivityGroup の ID フィールドのサブセットである必要があります。 | ActivityType の ActivityGroupId フィールドは、アプリ マニフェストの ActivityGroup の Id フィールドのサブセットではありません。 |
ActivityTypesMustExistWithActivitiesGroupValidation |
アクティビティの種類が見つからない場合は、マニフェストにアクティビティ グループを含めてはいけません。 | ActivityGroup プロパティを使用できますが、アプリ マニフェストに ActivityType プロパティがありません。 |
ApiBasedComposeExtensionApiResponseRenderingTemplateFileNullOrEmpty |
API ベースの compose 拡張機能には、マニフェストで apiResponseRenderingTemplateFile が定義されている必要があります。 | API ベースの compose 拡張機能には、アプリ マニフェストで apiResponseRenderingTemplateFile が定義されていません。 |
ApiBasedComposeExtensionApiSpecificationFileNullOrEmpty |
API ベースの compose 拡張機能には、マニフェストで apiSpecificationFile が定義されている必要があります。 | API ベースの compose 拡張機能には、アプリ マニフェストで apiSpecificationFile が定義されていません。 |
ApiBasedComposeExtensionManifestCommandIdsNotIncludedInOperationIdsOnApiSpecficationFile |
マニフェストのコマンド ID は、API 仕様ファイルの操作 ID には含まれません。 | アプリ マニフェストのコマンド ID が API 仕様ファイルの操作 ID に含まれていない場合に発生するエラー。 |
ApiBasedComposeExtensionWithBotId |
API ベースの compose 拡張機能で botId を定義することはできません。 | API ベースの compose 拡張機能には、アプリ マニフェストで botId が定義されています。 |
ApiBasedComposeExtensionWithCanUpdateConfiguration |
API ベースの compose 拡張機能では、マニフェストで canUpdateConfiguration を定義することはできません。 | API ベースの compose 拡張機能には、アプリ マニフェストで canUpdateConfiguration が定義されています。 |
ApiBasedComposeExtensionWithNoParameter |
API ベースの compose 拡張機能には、マニフェストでコマンド パラメーターが定義されている必要があります。 | API ベースの compose 拡張機能には、アプリ マニフェストで定義されているコマンド パラメーターがありません。 |
ApiSecretServiceAuthTypeComposeExtensionContainsMsftEntraConfiguration |
apiSecretServiceAuth authType を使用した API ベースの compose 拡張機能には、microsoftEntraConfiguration が定義されています。 | API ベースの compose 拡張機能には、アプリ マニフェストで microsoftEntraConfiguration が定義されています。 |
ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretRegistrationId |
apiSecretServiceAuth authType を使用した API ベースの compose 拡張機能には、apiSecretRegistrationId が定義されていません。 | apiSecretRegistrationId がアプリ マニフェストで定義されていない apiSecretServiceAuth authType を使用した API ベースの compose 拡張機能。 |
ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretServiceAuthConfiguration |
apiSecretServiceAuth authType を使用した API ベースの compose 拡張機能には、apiSecretServiceConfiguration がありません。 | API ベースの compose 拡張機能では、アプリ マニフェストで supportsingleSignOn が true に設定されていません。 |
ApiSpecificationFileContainUnsupportedHttpMethod |
API ベースの compose 拡張機能には、apiSpecificationFile でサポートされていない http メソッドが定義されているサーバー URL があります。 現在、GET と POST のみがサポートされています。 | API ベースの compose 拡張機能には、apiSpecificationFile で定義されているサポートされていない http メソッドがあります。 |
ApiSpecificationFileParameterContainUnsupportedSchemaType |
API ベースの compose 拡張機能には、apiSpecificationFile.Arrays で定義されているサポートされていないパラメーター スキーマ型があります。サポートされていません。 | API ベースの compose 拡張機能には、apiSpecificationFile で定義されているサポートされていないパラメーター スキーマ型があります。 |
ApiSpecificationFileRequestBodyContainUnsupportedMediaType |
API ベースの compose 拡張機能には、apiSpecificationFile の要求本文で定義されているサポートされていないメディアの種類があります。 現在、サポートされているのは application/json のみです。 | API ベースの compose 拡張機能には、apiSpecificationFile の要求本文で定義されているサポートされていないメディアの種類があります。 |
ApiSpecificationFileRequestBodyContainUnsupportedSchemaType |
API ベースの compose 拡張機能には、apiSpecificationFile の要求本文で定義されているスキーマの種類がサポートされていません。 現在、配列はサポートされていません。 | API ベースの compose 拡張機能には、apiSpecificationFile の要求本文で定義されているサポートされていないスキーマ型があります。 |
ApiSpecificationFileRequestBodySchemaContainKeywords |
API ベースの compose 拡張機能にはキーワードがあります。 | API ベースの compose 拡張機能には、apiSpecificationFile の要求本文で定義されたキーワードがあります。 |
ApiSpecificationFileRequiredParameterContainUnsupportedLocation |
API ベースの compose 拡張機能には、 {0}の apiSpecificationFile で定義されているサポートされていないパラメーターの場所があります。 現在サポートされているのは、パスとクエリのみです。 | API ベースの compose 拡張機能には、apiSpecificationFile で定義されているサポートされていないパラメーターの場所があります。 |
ApiSpecificationFileRequiredParameterOrPropertyNotDefinedOnManifest |
API ベースの compose 拡張機能には、マニフェストで定義されていない {0} 必要なパラメーターまたはプロパティがあります。 | API ベースの compose 拡張機能には、アプリ マニフェストで定義されていない必須のパラメーターがあります。 |
ApiSpecificationFileResponseContainUnsupportedMediaType |
API ベースの compose 拡張機能には、apiSpecificationFile に対する応答でサポートされていないメディアの種類が定義されています。 現在、サポートされているのは application/json のみです。 | API ベースの compose 拡張機能には、apiSpecificationFile で応答で定義されているサポートされていないメディアの種類があります。 |
ApiSpecificationFileServerUrlsContainHttp |
API ベースの compose 拡張機能には、apiSpecificationFile で http プロトコルが定義されているサーバー URL があります。 | API ベースの compose 拡張機能には、apiSpecificationFile に http プロトコルを含むサーバー URL があります。 |
ApiSpecificationFileServerUrlsContainInvalidUrl |
API ベースの compose 拡張機能には、apiSpecificationFile で定義されている無効な URL であるサーバー URL があります。 | API ベースの compose 拡張機能には、apiSpecificationFile で無効な URL が定義されています。 |
BotBasedComposeExtensionApiResponseRenderingTemplateFileExists |
ボット ベースの compose 拡張機能では、apiResponseRenderingTemplateFile を定義できません。 | ボットベースの compose 拡張機能には、アプリ マニフェストで定義されている apiResponseRenderingTemplateFile プロパティがあります。 |
BotBasedComposeExtensionApiSpecificationFileExists |
ボット ベースの compose 拡張機能で apiSpecificationFile を定義することはできません。 | ボットベースの compose 拡張機能には、アプリ マニフェストで定義された API 仕様ファイルがあります。 |
BotBasedComposeExtensionBotIdNotGuid |
ボット ベースの compose 拡張機能には GUID botId が必要です。 | ボットベースの compose 拡張機能 botId は GUID ではありません。 |
BotIdIsNotGuid |
BotId は Guid 値ではありません。 | アプリ マニフェストの 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 が使用されませんでした。 |
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 にする必要があります。 | アウトライン アイコンのサイズが正しくありません。 |
InvalidOutlineIconTransparency |
アウトライン アイコンが透明ではありません。 アルファです。 | アウトライン アイコンには、透明でも白でもないピクセルが含まれており、アルファ、R、G、B の値が {0}、 {1}、 {2}、 {3}。 |
MsftEntraAuthTypeComposeExtensionContainsApiSecretServiceConfiguration |
microsoftEntra authType を使用した API ベースの compose 拡張機能には、apiSecretServiceConfiguration が定義されています。 | API ベースの compose 拡張機能には、マニフェストで apiSecretServiceConfiguration が定義されています。 |
MsftEntraAuthTypeComposeExtensionContainsNoMsftEntraConfiguration |
microsoftEntra authType を使用した API ベースの compose 拡張機能には、microsoftEntraConfiguration が定義されていません。 | API ベースの compose 拡張機能には、アプリ マニフェストで microsoftEntraConfiguration が定義されていません。 |
MsftEntraAuthTypeComposeExtensionResourceURLNotMatchServerURLOnApiSpec |
マニフェストの microsoftEntra authType リソース URL を使用した API ベースの compose 拡張機能が、API 仕様ファイルのサーバー URL と一致しません。 | アプリ マニフェストの microsoftEntra authType リソース URL を使用した API ベースの compose 拡張機能が、API 仕様ファイルのサーバー URL と一致しません。 |
MsftEntraAuthTypeComposeExtensionSupportsSingleSignOnFalse |
microsoftEntra authType を使用した API ベースの compose 拡張機能では、supportsSingleSignOn が true に設定されていません。 | API ベースの compose 拡張機能では、アプリ マニフェストで supportsSingleSignOn を true に設定していません。 |
MsftEntraAuthTypeComposeExtensionWebApplicationInfoOrResourceNotDefined |
microsoftEntra authType を使用した API ベースの compose 拡張機能には、マニフェストで webApplicationInfo またはリソースが定義されていません。 | microsoftEntra authType を使用した API ベースの compose 拡張機能には、アプリ マニフェストで webApplicationInfo またはリソースが定義されていません。 |
NoAuthTypeComposeExtensionContainsAuthConfiguration |
authType に認証関連の構成が定義されていない API ベースの compose 拡張機能。 | authType microsoftEntraConfiguration または apiSecretServiceConfiguration を使用する API ベースの compose 拡張機能は、アプリ マニフェストで定義されていません。 |
ParameterOnManifestNotDefinedOnApiSpecFile |
API ベースの compose 拡張機能には、API 仕様ファイルで定義されていないマニフェストに {0} パラメーターがあります。 | アプリ マニフェストの API ベースの compose 拡張パラメーターは、API 仕様ファイルでは定義されていません。 |
ReservedActivitiesValidation |
マニフェストには、予約されたアクティビティの種類 'systemDefault' を含めてはいけません。 | systemDefault アクティビティの種類は、アプリ マニフェストで定義されます。 |
ReservedStaticTabNameShouldBeNull |
予約済みタブの [名前] プロパティを指定しないでください。 | 予約済みの staticTabs name プロパティが指定されました。 |
SchemaError_AdditionalItems |
スキーマでは、追加の項目は許可されません。 | アプリ マニフェスト ファイルがスキーマの additionalItems 検証に失敗しました。 |
SchemaError_AdditionalProperties |
プロパティ {0} が定義されておらず、スキーマでは追加のプロパティが許可されていません。 | アプリ マニフェスト ファイルは、スキーマの追加のProperties 検証に失敗しました。 ここで、 {0} は追加のプロパティを表します。 |
SchemaError_AllOf |
JSON が "allOf" のすべてのスキーマと一致するとは限りません。 | アプリ マニフェスト ファイルは、スキーマの allOf 検証に失敗しました。 |
SchemaError_AnyOf |
JSON が "anyOf" のスキーマと一致しません。 | アプリ マニフェスト ファイルがスキーマの anyOf 検証に失敗しました。 |
SchemaError_Const |
値 {0} が定数 {1}と一致しません。 | アプリ マニフェスト ファイルがスキーマの const 検証に失敗しました。 ここでは、 {0} は失敗した値を表し、 {1} は正しい値を表します。 |
SchemaError_Contains |
配列に必要な項目が含まれていない。 | アプリ マニフェスト ファイルに、スキーマの検証が含まれているに失敗しました。 |
SchemaError_ContentEncoding |
文字列 {0} は、コンテンツ エンコード {1}に対して検証されません。 | アプリ マニフェスト ファイルが、スキーマの contentEncoding 検証に失敗しました。 ここでは、 {0} はコンテンツ エンコードと一致しない文字列を表し、 {1} は想定されるコンテンツ エンコードを表します。 |
SchemaError_Dependencies |
プロパティの依存関係 {0} 失敗しました。 必要なキーがありません。 | アプリ マニフェスト ファイルは、スキーマの依存関係の検証に失敗しました。 ここでは、 {0} は失敗したプロパティを表します。 |
SchemaError_Else |
JSON が "else" のスキーマと一致しません。 | アプリ マニフェスト ファイルは、スキーマの else 検証に失敗しました。 |
SchemaError_Enum |
値 {0} は列挙型で定義されていません。 | アプリ マニフェスト ファイルがスキーマの列挙検証に失敗しました。 ここでは、 {0} 列挙型にない値を表します。 |
SchemaError_Format |
文字列 {0} は、形式 {1}に対して検証されません。 | アプリ マニフェスト ファイルがスキーマの形式検証に失敗しました。 ここでは、 {0} は想定される形式ではない文字列を表し、 {1} は想定される形式を表します。 |
SchemaError_Id |
重複するスキーマ ID {0} 検出されました。 | アプリ マニフェスト ファイルがスキーマの ID 検証に失敗しました。 ここで、 {0} はスキーマの ID を表します。 |
SchemaError_Maximum |
整数 {0} が {1}の最大値を超えています。 | アプリ マニフェスト ファイルが、スキーマの最大検証に失敗しました。 ここで、 {0} は最大値を超える値を表し、 {1} は最大値を表します。 |
SchemaError_MaximumItems |
配列項目数{0}{1}の最大数を超えています。 | アプリ マニフェスト ファイルが、スキーマの maximumItems 検証に失敗しました。 ここで、 {0} は配列内の要素の数を表し、 {1} は許可される最大値を表します。 |
SchemaError_MaximumLength |
文字列 {0} が {1}の最大長を超えています。 | アプリ マニフェスト ファイルが、スキーマの maximumLength 検証に失敗しました。 ここでは、 {0} は最大長を超える文字列を表し、 {1} は最大長を表します。 |
SchemaError_MaximumProperties |
オブジェクト プロパティの数{0}{1}の最大数を超えています。 | アプリ マニフェスト ファイルが、スキーマの maximumProperties 検証に失敗しました。 ここで、 {0} は指定されたプロパティの数を表し、 {1} は許可される最大プロパティを表します。 |
SchemaError_Minimum |
整数 {0} は、 {1}の最小値未満です。 | アプリ マニフェスト ファイルは、スキーマの最小検証に失敗しました。 ここで、 {0} は最小制限を超える値を表し、 {1} は最小制限を表します。 |
SchemaError_MinimumItems |
配列項目数 {0} は、 {1}の最小カウント未満です。 | アプリ マニフェスト ファイルが、スキーマの minimumItems 検証に失敗しました。 ここで、 {0} は配列内の要素の数を表し、 {1} は許可される最小値を表します。 |
SchemaError_MinimumLength |
文字列 {0} は、 {1}の最小長未満です。 | アプリ マニフェスト ファイルが、スキーマの minimumLength 検証に失敗しました。 ここでは、 {0} は最小長未満の文字列を表し、 {1} は最小値を表します。 |
SchemaError_MinimumProperties |
オブジェクト プロパティの数 {0} が、 {1}の最小数未満です。 | アプリ マニフェスト ファイルが、スキーマの minimumProperties 検証に失敗しました。 ここで、 {0} は指定されたプロパティの数を表し、 {1} は許可される最小プロパティを表します。 |
SchemaError_MultipleOf |
整数 {0} は、 {1}の倍数ではありません。 | アプリ マニフェスト ファイルがスキーマの multipleOf 検証に失敗しました。 ここで、 {0} は整数値を表し、 {1} は必要な倍数を示します。 |
SchemaError_Not |
JSON は、"not" からのスキーマに対して有効です。 | アプリ マニフェスト ファイルは、スキーマの検証に失敗しました。 |
SchemaError_OneOf |
JSON は、"oneOf" からの複数のスキーマに対して有効です。 | アプリ マニフェスト ファイルがスキーマの oneOf 検証に失敗しました。 |
SchemaError_Other |
値は、このプロパティのスキーマに準拠していません。 | アプリ マニフェスト ファイルは、スキーマの他の未処理の検証に失敗しました。 |
SchemaError_Pattern |
文字列 {0} が正規表現パターン "{1}" と一致しません。 | アプリ マニフェスト ファイルがスキーマのパターン検証に失敗しました。 ここでは、 {0} はパターンと一致しない値を表し、 {1} は予期されるパターンを表します。 |
SchemaError_PatternProperties |
正規表現パターン "{0}" でプロパティ名をテストできませんでした。 | アプリ マニフェスト ファイルは、スキーマの patternProperties 検証に失敗しました。 ここでは、 {0} プロパティのパターンを表します。 |
SchemaError_Required |
オブジェクトに必要なプロパティがありません: {0}。 | アプリ マニフェスト ファイルが、スキーマの必要な検証に失敗しました。 ここで、 {0} は必要なプロパティを表します。 |
SchemaError_Then |
JSON が "then" からのスキーマと一致しません。 | アプリ マニフェスト ファイルは、スキーマの検証に失敗しました。 |
SchemaError_Type |
値 {0} は、予期される型の {1}ではありません。 | アプリ マニフェスト ファイルがスキーマの型検証に失敗しました。 ここでは、 {0} は想定される型に含まれていない文字列を表し、 {1} は予期される型を表します。 |
SchemaError_UniqueItems |
配列には、一意ではない項目が含まれています。 | アプリ マニフェスト ファイルが、スキーマの uniqueItems 検証に失敗しました。 |
SchemaError_Valid |
スキーマは常に検証に失敗します。 | アプリ マニフェスト ファイルがスキーマの有効な検証に失敗しました。 |
Serialization_FileMissing |
{0}ファイルがアプリ パッケージに見つかりませんでした。 | アプリ パッケージに予期されるファイルがありません。 |
Serialization_FileNotValidJson |
ファイルを JSON オブジェクトとして解析できませんでした。 | 送信されたファイルが有効な JSON 形式に準拠していません。 |
Serialization_ManifestVersionPropertyMissing |
ファイルに "{0}" プロパティが含まれません。 | マニフェスト マニフェスト ファイルに manifestVersion プロパティがありません。 ここでは、 {0}manifestVersion プロパティの文字列を表します。 |
Serialization_TrailingCommaInManifestJsonFile |
マニフェスト json ファイルには、末尾のコンマが含まれています。 | アプリ マニフェスト ファイルには、末尾にコンマが含まれています。 |
ServerUrlsMissingOnApiSpecificationFile |
API ベースの compose 拡張機能には、apiSpecificationFile で定義されたサーバー URL がありません。 | 発生するエラー API ベースの compose 拡張機能に、apiSpecificationFile で定義されているサーバー URL がありません。 |
ShortDescriptionCannotBeEmpty |
短い説明を空にすることはできません | 簡単な説明は空でした。 |
ShortDescriptionLengthCheck |
短い説明の最大文字数は、80 文字を超えてはなりません。 | 短い説明は 80 文字を超えています。 |
ShortNameEqualsReservedName |
アプリの短い名前を予約名にすることはできません。 | 短い名前は予約済み名です。 |
ShortNameIsRequiredField |
アプリの短い名前を空にすることはできません。 | 短い名前は空です。 |
ShortNameLengthCheck |
短い名前の最大文字数は 30 文字を超えることはできません。 | 短い名前は 30 文字を超えています。 |
StaticTabNameCouldNotBeEmpty |
予約されていない staticTabs "Name" プロパティを空にすることはできません。 | staticTabs name プロパティが空です。 |
UniqueActivityTypeInActivitiesValidation |
マニフェストに重複するアクティビティの種類を含めてはいけません。 | アクティビティの種類は、アプリ マニフェストで一意ではありません。 |
UniqueIdInActivitiesGroupValidation |
アクティビティ グループにマニフェストに重複する ID を含めてはいけません。 | アクティビティ グループ ID は、アプリ マニフェストで一意ではありません。 |
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 を超える必要があります。 |
例
例 1: アプリ カタログにアプリを発行する
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/beta/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: レビュー用の新しいアプリケーションをorganizationのアプリ カタログにアップロードする
要求
次の例は要求を示しています。
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",
"displayName": "Test App",
"distributionMethod": "organization"
}
例 3: アプリのレビュー待ちを承認または拒否する
要求
次の例は要求を示しています。
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
}
例 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"
}
}
}