Телеантенна схемы


Reference: Manifest schema for Microsoft Teams

Note

For help on migrating your v0.4 manifest to v1.x, see our migration guide.

The Microsoft Teams manifest describes how the app integrates into the Microsoft Teams product.

Your manifest must conform to the schema hosted at. Versions 1.0 and 1.1 are also supported.

The following schema sample shows all extensibility options.

Sample full schema

The schema defines the following properties:

$schema

Optional, but recommended – String

The URL referencing the JSON Schema for the manifest.

Tip

Specify the schema at the beginning of your manifest to enable IntelliSense or similar support from your code editor:

manifestVersion

Required – String

The version of the manifest schema this manifest is using.

It should be "1.2".

version

Required – String

The version of the specific app. If you update something in your manifest, the version must be incremented as well. This телеантенна схемы, when the new manifest is installed, it will overwrite the телеантенна схемы one and the user will get the new functionality. If this app was submitted to the store, the new manifest will have to be re-submitted and re-validated.

Then, users of this app will get the new updated manifest automatically in a few hours, after it is approved.

If телеантенна схемы app requested permissions change, users will be prompted to upgrade and re-consent to the app.

This version string must follow the semver standard (MAJOR.MINOR.PATH).

id

Required – Microsoft app ID

The unique Microsoft-generated identifier for this app.

If you have registered a bot via the Microsoft Bot Framework, or your tab's web app already телеантенна схемы in with Microsoft, you should already have an Телеантенна схемы and should enter it here.

Otherwise, you should generate телеантенна схемы new ID at the Microsoft Application Registration Portal (My Applications), enter it here, and then reuse it when you add a bot.

packageName

Required – String

A unique identifier for this app in reverse domain notation; for example, com.example.myapp.

developer

Required

Specifies information about your company.

For apps submitted to AppSource (formerly Office Store), these values must match the information телеантенна схемы your AppSource entry.

NameMaximum sizeRequiredDescription
32 charactersThe display name телеантенна схемы the developer.
2048 charactersThe URL to the developer's website.

This link should take users to your company or product-specific landing page.

2048 charactersThe URL to the developer's privacy policy.
2048 charactersThe URL to the developer's terms of use.

name

Required

The name of your app experience, displayed to users in the Teams experience.

For apps submitted to AppSource, телеантенна схемы values must match the information in your AppSource entry.

NameMaximum sizeRequiredDescription
30 charactersThe short display name for the app.
100 charactersThe full name of the app, used if the full app name exceeds телеантенна схемы characters.

description

Required

Describes your app to users.

For apps submitted to Телеантенна схемы, these values must match the information in your AppSource entry.

Ensure that your description accurately describes телеантенна схемы experience and provides information to help potential customers understand what your experience does. You should also note, in the full description, if an external account is required for use.

NameMaximum sizeRequiredDescription
80 charactersA short description of your app experience, used when space is limited.
4000 charactersThe full телеантенна схемы of your app.

Important

We currently have an issue with full descriptions longer than 256 characters.

You can use a longer description in your Seller Телеантенна схемы app submission.

icons

Required

Icons телеантенна схемы within the Teams app.

The icon files must be included as part of the upload package. See Icons for more information.

NameMaximum sizeRequiredDescription
2048 charactersA relative file path to a transparent 32x32 PNG outline icon.
2048 charactersA relative file path to a full color 192x192 PNG icon.

accentColor

Required – String

A color to use in conjunction with and as a background for your outline icons.

The value must be a valid HTML color code starting with '#', for example .

configurableTabs

Optional

Used when your app experience has a team channel tab experience that requires extra configuration before it телеантенна схемы added.

Configurable tabs are supported only in the teams scope, and currently only one tab per телеантенна схемы is supported.

The object is an array телеантенна схемы all elements of the type.

This block is required only for solutions that provide a configurable channel tab solution.

NameTypeMaximum sizeRequiredDescription
String2048 charactersThe URL to use when configuring the tab.
BooleanA value indicating whether an instance of the tab's configuration can be updated by the user after creation.

Default:

Array of enum1Currently, configurable tabs support only телеантенна схемы scope, which means it can be provisioned only to a channel.

staticTabs

Optional

Defines a set of tabs that can be "pinned" by default, without the user adding them manually. Static tabs declared in scope are always телеантенна схемы to the app's personal experience.

Static tabs declared in the scope are currently not supported.

The object is an array (maximum of 16 elements) with all elements of the type.

телеантенна схемы

This block is required only for solutions that provide a static tab solution.

NameTypeMaximum sizeRequiredDescription
String64 charactersA unique identifier for the entity that the tab displays.
String128 charactersThe display name of the tab in the channel interface.
String2048 charactersThe URL that points to the entity UI to be displayed in the Teams canvas.

Must be HTTPS.

String2048 charactersThe Телеантенна схемы to point at if a user opts to view in a browser.
Array of enum1Currently, static tabs support only телеантенна схемы scope, which means it can be provisioned only as part of the personal experience.

bots

Optional

Defines a bot solution, along with optional information such as default телеантенна схемы properties.

The object is an array (maximum of only 1 element—currently only one bot is allowed per app) with all elements of the type.

This block is required only for solutions телеантенна схемы provide a bot experience.

NameTypeMaximum sizeRequiredDescription
String64 charactersThe unique Microsoft app ID for the bot as registered with the Bot Framework. This may well be the same as the overall app ID.
BooleanDescribes whether or not the bot utilizes a телеантенна схемы hint to add the bot to a specific channel.

Default:

BooleanIndicates whether a bot is a one-way, notification-only телеантенна схемы, as opposed to a conversational bot. Default:
Array of enum2Specifies whether the телеантенна схемы offers an experience in the context of a channel in aor an experience scoped to an individual user alone ().

These options are non-exclusive.

bots: commandLists

An optional list of commands that телеантенна схемы bot can recommend to users.

The object is an array телеантенна схемы of 2 elements) with телеантенна схемы elements of type ; you must define a separate command list for each scope that your bot supports.

See Bot menus for more information.

NameTypeMaximum sizeRequiredDescription
array of enum2Specifies the scope for which the command list is valid.
array of objects10An array of commands the bot supports:
: the bot command name (string, 32)
: a simple description or example of the command телеантенна схемы and its argument (string, 128)

connectors

Optional

The block defines an Office 365 Connector for the app.

The object is an array (maximum of 1 element) with all elements of type.

This block is required only for solutions that provide a Connector.

NameTypeMaximum sizeRequiredDescription
String64 charactersA unique телеантенна схемы for the Connector that matches its ID in the Connectors Developer Portal.
Array of enum1Specifies whether the Connector offers an experience in the context of a телеантенна схемы in aor an experience scoped to an individual user alone ().

Currently, only the scope is supported.

composeExtensions

Optional

Defines a messaging extension for the app.

Note

The name of the feature was changed from "compose extension" to "messaging extension" in November, 2017, but the manifest name remains the same so that existing extensions continue to function.

The object is an array (maximum of 1 element) with all elements of type.

This block is required only for solutions that provide a messaging extension.

NameTypeMaximum SizeRequiredDescription
String64The unique Microsoft app ID for the bot that backs the messaging extension, телеантенна схемы registered with the Bot Телеантенна схемы.

This may well be the same as the overall app ID.

BooleanA value indicating whether the configuration of a messaging extension can be телеантенна схемы by the user. Телеантенна схемы default is .
Array of object1Array of commands the messaging extension supports

composeExtensions.commands

Your messaging extension should declare one or more commands.

Each command appears in Microsoft Teams as a potential interaction from the UI-based entry point.

Each command item is an телеантенна схемы with the following structure:

NameTypeMaximum sizeRequiredDescription
String64 charactersThe ID for the command
String32 charactersThe user-friendly command name
String128 charactersThe description that appears to users to indicate телеантенна схемы purpose of this command
BooleanA Boolean value that indicates whether the command should be run initially with no parameters.

Default:

Array of object5The list of parameters the command takes. Minimum: 1; maximum: 5
String64 charactersThe name of the parameter as it appears in the client.

This is included in the user request.

String32 charactersUser-friendly title for the parameter.
String128 charactersUser-friendly string that describes this parameter’s purpose.

permissions

Optional

An array of which specifies which permissions the app requests, which lets end users know how the extension will perform.

The following options are non-exclusive:

  •   Requires user identity information
  •   Requires permission to send direct messages to team members

validDomains

Optional, except Required for apps with tabs

A list of valid domains from which the extension expects to load any content.

Domain listings can include wildcards, for example. If your tab configuration or content UI needs to navigate to any other domain besides the one use for tab configuration, that domain must be specified here.

Important

Do not add domains that are outside your control, either directly or via wildcards.

For example, is valid, but телеантенна схемы not valid.

The object is an array with all elements of the type .

Источник: https://docs.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema



Copyright © 2018