App-Manifest

Das App-Manifest (zuvor als Teams-App-Manifest bezeichnet) beschreibt, wie Ihre App in das Microsoft Teams-Produkt integriert wird. Ihr App-Manifest muss dem Schema entsprechen, das auf https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.jsongehostet wird. Frühere Versionen 1.0, 1.1,...,1.17 und die aktuelle Version 1.19 werden jeweils unterstützt (mit "v1.x" in der URL). Version 1.18 ist nicht verfügbar. Weitere Informationen zu den Änderungen, die in den einzelnen Versionen vorgenommen wurden, finden Sie im Änderungsprotokoll des App-Manifests und für frühere Versionen unter App-Manifestversionen.

In der folgenden Tabelle sind die TeamsJS-Version und die Versionen der App-Manifeste für die verschiedenen App-Szenarien aufgeführt:

* Verwenden Sie nach Möglichkeit die neueste Version von TeamsJS (v.2.19.0 oder höher), um die neuesten Verbesserungen und die Unterstützung neuer Features zu nutzen, einschließlich Nur-Teams-Apps. TeamsJS v.1.12 wird weiterhin unterstützt, es werden jedoch keine neuen Features oder Verbesserungen hinzugefügt. Die Schemas 1.12 und 1.13 sind ansonsten identisch. Weitere Informationen finden Sie unter TeamsJS-Bibliothek.

Es folgt das Beispiel für das App-Manifestschema:

Beispiel-App-Manifest

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json",
    "manifestVersion": "1.19",
    "version": "1.0.0",
    "id": "%MICROSOFT-APP-ID%",
    "localizationInfo": {
        "defaultLanguageTag": "en",
        "defaultLanguageFile": "en.json",
        "additionalLanguages": [
            {
                "languageTag": "es",
                "file": "es.json"
            }
        ]
    },
    "developer": {
        "name": "Publisher Name",
        "websiteUrl": "https://example.com/",
        "privacyUrl": "https://example.com/privacy",
        "termsOfUseUrl": "https://example.com/app-tos",
        "mpnId": "1234567890"
    },
    "name": {
        "short": "Name of your app (<=30 chars)",
        "full": "Full name of app, if longer than 30 characters (<=100 chars)"
    },
    "description": {
        "short": "Short description of your app (<= 80 chars)",
        "full": "Full description of your app (<= 4000 chars)"
    },
    "icons": {
        "outline": "A relative path to a transparent .png icon — 32px X 32px",
        "color": "A relative path to a full color .png icon — 192px X 192px"
    },
    "accentColor": "A valid HTML color code.",
    "copilotAgents": {
        "declarativeAgents": [
            {
                "id": "agent1",
                "file": "declarativeAgent1.json"
            }
        ]
    },
    "configurableTabs": [
        {
            "configurationUrl": "https://contoso.com/teamstab/configure",
            "scopes": [
                "team",
                "groupChat"
            ],
            "canUpdateConfiguration": true,
            "context": [
                "channelTab",
                "privateChatTab",
                "meetingChatTab",
                "meetingDetailsTab",
                "meetingSidePanel",
                "meetingStage"
            ],
            "sharePointPreviewImage": "Relative path to a tab preview image for use in SharePoint — 1024px X 768",
            "supportedSharePointHosts": [
                "sharePointFullPage",
                "sharePointWebPart"
            ]
        }
    ],
    "staticTabs": [
        {
            "entityId": "unique Id for the page entity",
            "scopes": [
                "personal"
            ],
            "context": [
                "personalTab",
                "channelTab"
            ],
            "name": "Display name of tab",
            "contentUrl": "https://contoso.com/content (displayed in Teams canvas)",
            "websiteUrl": "https://contoso.com/content (displayed in web browser)",
            "searchUrl": "https://contoso.com/content (displayed in web browser)"
        }
    ],
    "supportedChannelTypes": [
        "sharedChannels",
        "privateChannels"
    ],
    "bots": [
        {
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "scopes": [
                "team",
                "personal",
                "groupChat"
            ],
            "needsChannelSelector": false,
            "isNotificationOnly": false,
            "supportsFiles": true,
            "supportsCalling": false,
            "supportsVideo": true,
            "commandLists": [
                {
                    "scopes": [
                        "team",
                        "groupChat"
                    ],
                    "commands": [
                        {
                            "title": "Command 1",
                            "description": "Description of Command 1"
                        },
                        {
                            "title": "Command 2",
                            "description": "Description of Command 2"
                        }
                    ]
                },
                {
                    "scopes": [
                        "personal",
                        "groupChat"
                    ],
                    "commands": [
                        {
                            "title": "Personal command 1",
                            "description": "Description of Personal command 1"
                        },
                        {
                            "title": "Personal command N",
                            "description": "Description of Personal command N"
                        }
                    ]
                }
            ]
        }
    ],
    "connectors": [
        {
            "connectorId": "GUID-FROM-CONNECTOR-DEV-PORTAL%",
            "scopes": [
                "team"
            ],
            "configurationUrl": "https://contoso.com/teamsconnector/configure"
        }
    ],
    "composeExtensions": [
        {
            "canUpdateConfiguration": true,
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "commands": [
                {
                    "id": "exampleCmd1",
                    "title": "Example Command",
                    "type": "query",
                    "context": [
                        "compose",
                        "commandBox"
                    ],
                    "description": "Command Description; e.g., Search on the web",
                    "initialRun": true,
                    "fetchTask": false,
                    "parameters": [
                        {
                            "name": "keyword",
                            "title": "Search keywords",
                            "inputType": "choiceset",
                            "description": "Enter the keywords to search for",
                            "value": "Initial value for the parameter",
                            "choices": [
                                {
                                    "title": "Title of the choice",
                                    "value": "Value of the choice"
                                }
                            ]
                        }
                    ]
                },
                {
                    "id": "exampleCmd2",
                    "title": "Example Command 2",
                    "type": "action",
                    "context": [
                        "message"
                    ],
                    "description": "Command Description; e.g., Add a customer",
                    "initialRun": true,
                    "fetchTask": false ,
                    "parameters": [
                        {
                            "name": "custinfo",
                            "title": "Customer name",
                            "description": "Enter a customer name",
                            "inputType": "text"
                        }
                    ]
                },
                {
                    "id": "exampleCmd3",
                    "title": "Example Command 3",
                    "type": "action",
                    "context": [
                        "compose",
                        "commandBox",
                        "message"
                    ],
                    "description": "Command Description; e.g., Add a customer",
                    "fetchTask": false,
                    "taskInfo": {
                        "title": "Initial dialog title",
                        "width": "Dialog width",
                        "height": "Dialog height",
                        "url": "Initial webview URL"
                    }
                }
            ],
            "messageHandlers": [
                {
                    "type": "link",
                    "value": {
                        "domains": [
                            "mysite.someplace.com",
                            "othersite.someplace.com"
                        ],
                        "supportsAnonymizedPayloads": false
                    }
                }
            ]
        }
    ],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "devicePermissions": [
        "geolocation",
        "media",
        "notifications",
        "midi",
        "openExternal"
    ],
    "validDomains": [
        "contoso.com",
        "mysite.someplace.com",
        "othersite.someplace.com"
    ],
    "webApplicationInfo": {
        "id": "AAD App ID",
        "resource": "Resource URL for acquiring auth token for SSO"
    },
    "authorization": {
        "permissions": {
            "resourceSpecific": [
                {
                    "type": "Application",
                    "name": "ChannelSettings.Read.Group"
                },
                {
                    "type": "Delegated",
                    "name": "ChannelMeetingParticipant.Read.Group"
                }
            ]
        }
    },
    "showLoadingIndicator": false,
    "isFullScreen": false,
    "activities": {
        "activityTypes": [
            {
                "type": "taskCreated",
                "description": "Task created activity",
                "templateText": "<team member> created task <taskId> for you"
            },
            {
                "type": "userMention",
                "description": "Personal mention activity",
                "templateText": "<team member> mentioned you"
            }
        ]
    },
    "defaultBlockUntilAdminAction": true,
    "publisherDocsUrl": "https://example.com/app-info",
    "defaultInstallScope": "meetings",
    "defaultGroupCapability": {
        "meetings": "tab",
        "team": "bot",
        "groupchat": "bot"
    },
    "configurableProperties": [
        "name",
        "shortDescription",
        "longDescription",
        "smallImageUrl",
        "largeImageUrl",
        "accentColor",
        "developerUrl",
        "privacyUrl",
        "termsOfUseUrl"
    ],
    "subscriptionOffer": {
        "offerId": "publisherId.offerId"
    },
    "meetingExtensionDefinition": {
        "scenes": [
            {
                "id": "9082c811-7e6a-4174-8173-6ccd57d377e6",
                "name": "Getting started sample",
                "file": "scenes/sceneMetadata.json",
                "preview": "scenes/scenePreview.png",
                "maxAudience": 15,
                "seatsReservedForOrganizersOrPresenters": 0
            },
            {
                "id": "afeaed22-f89b-48e1-98b4-46a514344e4a",
                "name": "Sample-1",
                "file": "scenes/sceneMetadata.json",
                "preview": "scenes/scenePreview.png",
                "maxAudience": 15,
                "seatsReservedForOrganizersOrPresenters": 3
            }
        ]
    }
}

Das Schema definiert die folgenden Eigenschaften:

$schema

Optional, aber empfohlen– Zeichenfolge

Die https:// URL, die auf das JSON-Schema für das App-Manifest verweist.

manifestVersion

Erforderlich – Zeichenfolge

Die Version des App-Manifestschemas, das dieses Manifest verwendet. Verwenden Sie , um die Unterstützung von Teams-Apps in Outlook und Microsoft 365-Apps zu aktivieren. Verwenden Sie 1.131.12 (oder früher) für reine Teams-Apps.

Version

Erforderlich – Zeichenfolge

Die Version einer bestimmten App. Wenn Sie etwas in Ihrem App-Manifest aktualisieren, muss auch die Version erhöht werden. Auf diese Weise überschreibt das neue App-Manifest bei der Installation das vorhandene Manifest, und der Benutzer erhält die neue Funktionalität. Wenn diese App an den Microsoft Teams Store übermittelt wurde, muss das neue App-Manifest erneut übermittelt und erneut überprüft werden. Die App-Benutzer erhalten das neue aktualisierte App-Manifest automatisch innerhalb weniger Stunden nach der Genehmigung des App-Manifests.

Wenn sich die App-Berechtigungsanforderungen ändern, werden die Benutzer aufgefordert, ein Upgrade durchzuführen und der App erneut die Berechtigungen zu erteilen.

Diese Versionszeichenfolge muss dem SemVer-Standard entsprechen (MAJOR.MINOR.PATCH).

ID

Erforderlich : Microsoft-App-ID

Die ID ist ein eindeutiger, von Microsoft generierter Bezeichner für die App. Das Format der ID ist GUID. Sie verfügen über eine ID, wenn Ihr Bot über das Microsoft Bot Framework registriert ist. Sie verfügen über eine ID, wenn sich die Web-App Ihrer Registerkarte bereits bei Microsoft anmeldet. Sie müssen die ID hier eingeben. Andernfalls müssen Sie eine neue ID im Microsoft-Anwendungsregistrierungsportal generieren. Verwenden Sie die gleiche ID, wenn Sie einen Bot hinzufügen.

Die im Teams Admin Center gespeicherte ID ist die externe App-ID und wird in den Ablaufverfolgungen als ExternalID angezeigt.

developer

Erforderlich – Objekt

Gibt Informationen zu Ihrem Unternehmen an. Für Apps, die an den Teams Store übermittelt werden, müssen diese Werte mit den Informationen in Ihrem Teams Store-Eintrag übereinstimmen. Weitere Informationen finden Sie in den Teams Store-Veröffentlichungsrichtlinien. Der Name des Entwicklers trägt dazu bei, die Auffindbarkeit Ihrer App im Teams Store zu verbessern.

name

Erforderlich – Objekt

Der Name Ihrer App-Lösung, der Benutzern in der Microsoft Teams-Umgebung angezeigt wird. Für Apps, die an AppSource übermittelt werden, müssen diese Werte mit den Informationen in Ihrem AppSource-Eintrag übereinstimmen. Die Werte von short und full müssen unterschiedlich sein. Der App-Name trägt dazu bei, die Auffindbarkeit Ihrer App im Teams Store zu verbessern.

description

Erforderlich – Objekt

Beschreibt Ihre App für Benutzer. Für Apps, die an AppSource übermittelt werden, müssen diese Werte mit den Informationen in Ihrem AppSource-Eintrag übereinstimmen. Die App-Beschreibung trägt dazu bei, die Auffindbarkeit Ihrer App im Teams Store zu verbessern.

Stellen Sie sicher, dass Ihre Beschreibung Ihre Lösung beschreibt und potenziellen Kunden hilft zu verstehen, worin ihre Funktion besteht. Sie müssen in der vollständigen Beschreibung angeben, ob ein externes Konto für die Verwendung der App erforderlich ist. Die Werte von short und full müssen unterschiedlich sein. Ihre kurze Beschreibung kann nicht innerhalb der langen Beschreibung wiederholt werden und darf keinen anderen App-Namen enthalten.

localizationInfo

Optional – Objekt

Ermöglicht die Angabe einer Standardsprache und Zeiger auf zusätzliche Sprachdateien. Siehe Lokalisierung.

localizationInfo.additionalLanguages

Ein Array von -Objekten, die jeweils die folgenden Eigenschaften aufweisen, um zusätzliche Sprachübersetzungen anzugeben.

Symbole

Erforderlich – Objekt

Symbole, die in der Microsoft Teams-App verwendet werden. Die Symboldateien müssen als Teil des Uploadpakets enthalten sein. Weitere Informationen finden Sie unter Symbole.

accentColor

Erforderlich : HTML-Hexady-Farbcode

Eine Farbe, die und als Hintergrund für Ihre Farbsymbole verwendet werden soll.

Bei dem Wert muss es sich um einen gültigen HTML-Farbcode handeln, der mit "#" beginnt, z. B. #4464ee. Weitere Informationen finden Sie unter accentColor.

copilotAgents

Optional – Objekt

Definiert einen oder mehrere Agents, die Microsoft 365 Copilot. Deklarative Agents sind Anpassungen von Microsoft 365 Copilot, die auf denselben Orchestrator- und Basismodellen ausgeführt werden.

declarativeAgents

Stellt eine Anpassung von Microsoft 365 Copilot dar, wie durch die Manifestdatei definiert.

configurableTabs

Optional – Array

Wird verwendet, wenn Ihre App-Erfahrung über eine Teamkanalregisterkarte verfügt, die eine zusätzliche Konfiguration erfordert, bevor sie hinzugefügt wird. Konfigurierbare Registerkarten werden nur in den team- und groupChat-Bereichen unterstützt, und Sie können dieselben Registerkarten mehrmals konfigurieren. Sie können sie jedoch nur einmal im App-Manifest definieren.

staticTabs

Optional – Array

Definiert einen Satz von Registerkarten, die standardmäßig angeheftet werden können, ohne dass der Benutzer sie manuell hinzufügt. Im personal-Bereich deklarierte statische Registerkarten werden immer an die persönliche Benutzeroberfläche der App angeheftet. Die angehefteten Registerkarten können jedoch neu angeordnet werden, indem die Details der Registerkarte in der gewünschten Reihenfolge hinzugefügt werden. Weitere Informationen finden Sie unter Neuanordnen statischer persönlicher Registerkarten.

Mit dieser Eigenschaft können Sie auch die Standardzielfunktion für eine App festlegen, die sowohl Registerkarten- als auch Botfunktionen im persönlichen Bereich unterstützt. Weitere Informationen finden Sie unter Konfigurieren der Standardzielfunktion.

Dieses Element ist ein Array (maximal 16 Elemente), wobei alle Elemente vom Typ object sind. Dieser Block ist nur für Lösungen erforderlich, die eine Lösung mit statischen Registerkarten bereitstellen.

Bots

Optional – Array

Definiert eine Bot-Lösung zusammen mit optionalen Informationen wie Standardbefehlseigenschaften.

Das Element ist ein Array (maximal nur ein Element – nur ein Bot ist pro App zulässig) mit allen Elementen des Typs object. Dieser Block ist nur für Lösungen erforderlich, die einen Bot umfassen.

bots.configuration

Optional – Objekt

bots.commandLists

Optional – Array

Eine Liste der Befehle, die Ihr Bot Benutzern empfehlen kann. Das Objekt ist ein Array (maximal drei Elemente) mit allen Elementen des Typs object. Sie müssen eine separate Befehlsliste für jeden Bereich definieren, den Ihr Bot unterstützt. Weitere Informationen finden Sie unter Bot-Menüs.

bots.commandLists.commands

Erforderlich – Array

connectors

Optional – Array

Der connectors -Block definiert einen Connector Karte für Microsoft 365-Gruppen für die App.

Das Objekt ist ein Array (maximal ein Element), wobei alle Elemente vom Typ object sind. Dieser Block ist nur für Lösungen erforderlich, die einen Connector bereitstellen.

composeExtensions

Optional – Array

Definiert eine Nachrichtenerweiterung für die App.

Das Element ist ein Array (maximal ein Element), wobei alle Elemente vom Typ object sind. Dieser Block ist nur für Lösungen erforderlich, die eine Nachrichtenerweiterung bereitstellen.

composeExtensions.commands

Ihre Nachrichtenerweiterung muss mindestens einen Befehl deklarieren (maximal 10 Befehle insgesamt). Jeder Befehl wird in Microsoft Teams als potenzielle Interaktion vom Einstiegspunkt in der Benutzeroberfläche angezeigt.

Jedes Befehlselement ist ein Objekt mit folgender Struktur:

Berechtigungen

Optional : Array von Zeichenfolgen

Ein Array von string, das angibt, welche Berechtigungen die App anfordert, wodurch Endbenutzer wissen, wie die Erweiterung funktioniert. Die folgenden Optionen sind nicht exklusiv:

• identity Erfordert Benutzeridentitätsinformationen.
• messageTeamMembers Erfordert die Berechtigung zum Senden von direkten Nachrichten an Teammitglieder.

Wenn Sie diese Berechtigungen während der App-Aktualisierung ändern, müssen Ihre Benutzer den Zustimmungsprozess wiederholen, nachdem sie die aktualisierte App gestartet haben. Weitere Informationen finden Sie unter Aktualisieren Ihrer App.

devicePermissions

Optional : Array von Zeichenfolgen

Stellt die systemeigenen Features auf dem Gerät eines Benutzers bereit, für die Ihre App Zugriff anfordert. Mögliche Optionen sind:

• geolocation
• media
• notifications
• midi
• openExternal

validDomains

Optional (außer Erforderlich , falls angegeben) – Array von Zeichenfolgen

Eine Liste gültiger Domänen für Websites, die von der App im Microsoft Teams-Client geladen werden sollen. Domäneneinträge können Platzhalter enthalten, z. B. *.example.com. Die gültige Domäne entspricht genau einem Segment der Domäne. Wenn sie a.b.example.com entsprechen muss, verwenden Sie *.*.example.com. Wenn Ihre Registerkartenkonfiguration oder Inhalts-UI zu einer anderen Domäne als jener der Registerkartenkonfiguration führt, muss diese Domäne hier angegeben werden.

Schließen Sie nicht die Domänen von Identitätsanbietern ein, die in Ihrer App unterstützt werden sollen. Wenn Sie sich beispielsweise mit einer Google-ID authentifizieren möchten, müssen Sie zu accounts.google.com umleiten. Sie dürfen jedoch nicht accounts.google.com in validDomains[]einschließen.

Microsoft Teams-Apps, die ihre eigenen SharePoint-URLs benötigen, um ordnungsgemäß zu funktionieren, enthalten "{teamsitedomain}" in ihrer Liste zulässiger Domänen.

Das Objekt ist ein Array, wobei alle Elemente vom Typ string sind. Das maximale Element des Objekts ist 16 und die maximale Länge beträgt 2048 Zeichen.

webApplicationInfo

Optional – Objekt

Geben Sie Ihre Microsoft Entra App-ID und Microsoft Graph-Informationen an, damit sich Benutzer nahtlos bei Ihrer App anmelden können. Wenn Ihre App in Microsoft Entra ID registriert ist, müssen Sie die App-ID angeben. Administratoren können im Microsoft Teams Admin Center Berechtigungen einfach überprüfen und ihre Zustimmung erteilen.

graphConnector

Optional – Objekt

Geben Sie die Graph-Connectorkonfiguration der App an. Wenn dies vorhanden ist, muss auch webApplicationInfo.id angegeben werden.

showLoadingIndicator

Optional – Boolescher Wert

Gibt an, ob die Ladefortschritt angezeigt werden soll, während eine App oder Registerkarte geladen wird. Der Standardwert ist false.

isFullScreen

Optional – Boolescher Wert

Gibt an, ob eine persönliche App ohne Registerkartenkopfleiste gerendert wird (was den Vollbildmodus anzeigt). Standardwert: false

Aktivitäten

Optional – Objekt

Definiert die Eigenschaften, die Ihre App zum Posten eines Benutzeraktivitätsfeeds verwendet.

activities.activityTypes

{
   "activities":{
      "activityTypes":[
         {
            "type":"taskCreated",
            "description":"Task Created Activity",
            "templateText":"{actor} created task {taskId} for you"
         },
         {
            "type":"teamMention",
            "description":"Team Mention Activity",
            "templateText":"{actor} mentioned team"
         },
         {
            "type":"channelMention",
            "description":"Channel Mention Activity",
            "templateText":"{actor} mentioned channel"
         },
         {
            "type":"userMention",
            "description":"Personal Mention Activity",
            "templateText":"{actor} mentioned user"
         },
         {
            "type":"calendarForward",
            "description":"Forwarding a Calendar Event",
            "templateText":"{actor} sent user an invite on behalf of {eventOwner}"
         },
         {
            "type":"calendarForward",
            "description":"Forwarding a Calendar Event",
            "templateText":"{actor} sent user an invite on behalf of {eventOwner}"
         },
         {
            "type":"creatorTaskCreated",
            "description":"Created Task Created",
            "templateText":"The Creator created task {taskId} for you"
         }
      ]
   }
}

defaultInstallScope

Optional – Zeichenfolge

Gibt den standardmäßig für diese App definierten Installationsbereich an. Der Standardinstallationsbereich wird neben dem entsprechenden Bereich im Bereichsauswahldialogfeld mit der Option Empfohlen gekennzeichnet, nachdem der Benutzer die App hinzugefügt hat. Mögliche Optionen:

• personal
• team
• groupChat
• meetings

defaultGroupCapability

Optional – Objekt

Wenn ein Gruppeninstallationsbereich ausgewählt ist, wird die Standardfunktion definiert, wenn der Benutzer die App installiert.

configurableProperties

Optional – Array

Der configurableProperties -Block definiert die App-Eigenschaften, die Teams-Administratoren anpassen können. Weitere Informationen finden Sie unter Aktivieren der App-Anpassung. Die App-Anpassungsfunktion wird in benutzerdefinierten Apps oder benutzerdefinierten Apps, die für Ihre Organisation (BRANCHEN-Apps) erstellt wurden, nicht unterstützt.

Sie können eine der folgenden Eigenschaften definieren:

• name: Der Anzeigename der App.
• shortDescription: Die kurze Beschreibung der App.
• longDescription: Die lange Beschreibung der App.
• smallImageUrl: Das Kontursymbol der App.
• largeImageUrl: Das Farbsymbol der App.
• accentColor: Die zu verwendende Farbe und ein Hintergrund für Ihre Kontursymbole.
• developerUrl: Die HTTPS-URL der Website des Entwicklers.
• privacyUrl: Die HTTPS-URL der Datenschutzrichtlinie des Entwicklers.
• termsOfUseUrl: Die HTTPS-URL der Nutzungsbedingungen des Entwicklers.

supportedChannelTypes

Optional – Array

Aktiviert Ihre App in Kanälen die keine Standardkanäle sind. Wenn Ihre App einen Teambereich unterstützt und diese Eigenschaft definiert ist, aktiviert Microsoft Teams Ihre App in jedem Kanaltyp entsprechend. Die supportedChannelTypes-Eigenschaft unterstützt sharedChannels nur und privateChannels.

defaultBlockUntilAdminAction

Optional – Boolescher Wert

Wenn die defaultBlockUntilAdminAction-Eigenschaft auf true festgelegt ist, ist die App so lange standardmäßig für Benutzer ausgeblendet, bis der Administrator sie zulässt. Bei Festlegung auf true ist die App für alle Mandanten und Endbenutzer ausgeblendet. Die Teams-Administratoren können die App im Teams Admin Center anzeigen und Maßnahmen ergreifen, um die App zuzulassen oder zu blockieren. Der Standardwert ist false. Weitere Informationen zum Standardmäßigen App-Block finden Sie unter Blockieren von Apps standardmäßig für Benutzer, bis ein Administrator dies genehmigt.

publisherDocsUrl

Optional – Zeichenfolge

Maximale Größe – 2048 Zeichen

Der Wert des publisherDocsUrl Parameters ist eine sichere HTTPS-URL zur Dokumentations- und Informationsseite der App, die App-Entwickler angeben möchten. Teams-Administratoren erhalten dokumentationen zur App unter dieser URL. Teams Admin Center zeigt die URL auf der Seite mit den App-Details an. Die Dokumentation kann Anweisungen für Administratoren enthalten, um die App-Einführung und den App-Rollout zu erleichtern. In der App-Dokumentation können Sie auch Anweisungen oder Informationen zur App einfügen, die für den Teams-Administrator, Benutzer und andere Geschäftsbeteiligte nützlich sind.

subscriptionOffer

Optional – Objekt

Gibt das Ihrer App zugeordnete SaaS-Angebot an.

meetingExtensionDefinition

Optional – Objekt

Geben Sie die Besprechungserweiterungsdefinition an. Weitere Informationen finden Sie unter benutzerdefinierten Szenen im Zusammen-Modus in Teams.

meetingExtensionDefinition.scenes

Autorisierung

Optional – Objekt

Spezifizieren und konsolidieren Sie autorisierungsbezogene Informationen für die App.

authorization.permissions

authorization.permissions.resourceSpecific

RSC-Anwendungsberechtigungen

Anwendungsberechtigungen ermöglichen der App den Zugriff auf Daten, ohne dass ein Benutzer angemeldet ist. Informationen zu Anwendungsberechtigungen finden Sie unter RSC-Berechtigungen für Microsoft Graph und Microsoft BotSDK.

Delegierte RSC-Berechtigungen

Delegierte Berechtigungen ermöglichen der App den Zugriff auf Daten im Namen des angemeldeten Benutzers.

• Delegierte RSC-Berechtigungen für ein Team

  Name	Beschreibung
  ChannelMeetingParticipant.Read.Group	Ermöglicht es der App, im Namen des angemeldeten Benutzers die Teilnehmerinformationen (Name, Rolle, ID, Beitritts- und Abwesenheitszeiten) von Channel-Meetings zu lesen, die mit diesem Team verbunden sind.
  ChannelMeetingIncomingAudio.Detect.Group	Ermöglicht der App das Erkennen eingehender Audiodaten in Kanalbesprechungen, die dem Team zugeordnet sind.
  ChannelMeetingActiveSpeaker.Read.Group	Ermöglicht der App das Lesen der Teilnehmer, die Audiodaten an die Kanalbesprechungen senden, die dem Team zugeordnet sind.
  ChannelMeetingAudioVideo.Stream.Group	Ermöglicht der App das Streamen von Audio-Video-Inhalten aus Kanalbesprechungen, die dem Team zugeordnet sind.
  InAppPurchase.Allow.Group	Ermöglicht es der App, Marketplace-Angebote für Benutzer im Team anzuzeigen und ihre Einkäufe innerhalb der App im Namen des angemeldeten Benutzers abzuschließen.
  ChannelMeetingStage.Write.Group	Ermöglicht der App das Anzeigen von Inhalten auf der Besprechungsphase in Kanalbesprechungen, die dem Team zugeordnet sind, im Namen des angemeldeten Benutzers.
  LiveShareSession.ReadWrite.Group	Ermöglicht der App, Live Share-Sitzungen für das Team zu erstellen und zu synchronisieren und im Namen des angemeldeten Benutzers Zugriffsinformationen wie Name und Rolle, über die Teamliste und alle zugehörigen Besprechungen abzurufen.
  MeetingParticipantReaction.Read.Group	Ermöglicht der App das Lesen von Reaktionen von Teilnehmern in Kanalbesprechungen, die dem Team zugeordnet sind.

• DELEGIERTE RSC-Berechtigungen für Chats oder Besprechungen

  Name	Beschreibung
  InAppPurchase.Allow.Chat	Ermöglicht es der App, Marketplace-Angebote für die Benutzer im Chat und jede zugehörige Besprechung anzuzeigen und ihre Einkäufe innerhalb der App im Namen des angemeldeten Benutzers abzuschließen.
  MeetingStage.Write.Chat	Ermöglicht der App das Anzeigen von Inhalten auf der Besprechungsphase in Besprechungen, die dem Chat zugeordnet sind, im Namen des angemeldeten Benutzers.
  OnlineMeetingParticipant.Read.Chat	Ermöglicht der App das Lesen von Teilnehmerinformationen, einschließlich Name, Rolle, ID, Beigetretener und verlassener Zeiten, der Besprechung, die dem Chat zugeordnet ist, im Namen des angemeldeten Benutzers.
  OnlineMeetingParticipant.ToggleIncomingAudio.Chat	Ermöglicht der App das Umschalten eingehender Audiodaten für Teilnehmer an Besprechungen, die dem Chat zugeordnet sind, im Namen des angemeldeten Benutzers.
  LiveShareSession.ReadWrite.Chat	Ermöglicht der App, Live Share-Sitzungen für den Chat zu erstellen und zu synchronisieren und im Namen des angemeldeten Benutzers zugriffsbezogene Informationen wie Name und Rolle, über die Chatliste und alle zugehörigen Besprechungen zu erhalten.
  MeetingParticipantReaction.Read.Chat	Ermöglicht der App das Lesen von Reaktionen von Teilnehmern in Besprechungen, die dem Chat zugeordnet sind.
  OnlineMeetingIncomingAudio.Detect.Chat	Ermöglicht der App das Erkennen von Änderungen im status eingehender Audiodaten in Besprechungen, die dem Chat zugeordnet sind, im Namen des angemeldeten Benutzers.
  OnlineMeetingActiveSpeaker.Read.Chat	Ermöglicht der App das Lesen von Teilnehmern, die Audiodaten an die Besprechungen senden, die dem Chat zugeordnet sind.
  OnlineMeetingAudioVideo.Stream.Chat	Ermöglicht der App das Streamen von Audiovideoinhalten von Besprechungen, die dem Chat zugeordnet sind.

• Delegierte RSC-Berechtigungen für Benutzer

  Name	Beschreibung
  CameraStream.Read.User	Ermöglicht der App das Lesen des Kameradatenstroms des Benutzers.
  InAppPurchase.Allow.User	Ermöglicht es der App, dem Benutzer Angebote auf dem Marktplatz zu zeigen und die Einkäufe des Benutzers innerhalb der App im Namen des angemeldeten Benutzers abzuschließen.
  OutgoingVideoStream.Write.User	Ermöglicht der App, das ausgehende Video des Benutzers zu ändern.
  MicrophoneStream.Read.User	Ermöglicht der App das Lesen des Mikrofonstreams des Benutzers.
  MeetingParticipantReaction.Read.User	Ermöglicht der App, die Reaktionen von Benutzern während der Teilnahme an einer Besprechung zu lesen.

Erweiterungen

Optional – Objekt

Die extensions Eigenschaft gibt Outlook-Add-Ins innerhalb eines App-Manifests an und vereinfacht die Verteilung und den Erwerb im gesamten Microsoft 365-Ökosystem. Jede App unterstützt nur eine Erweiterung.

Weitere Informationen finden Sie unter Office-Add-Ins-Manifest für Microsoft 365.

extensions.requirements

Das extensions.requirements -Objekt gibt die Bereiche, Formfaktoren und Office JavaScript-Bibliotheksanforderungssätze an, die auf dem Office-Client unterstützt werden müssen, damit das Add-In installiert werden kann. Anforderungen werden auch für die ribbonuntergeordneten Eigenschaften , runtime, alternatesund autoRunEvents unterstützt, um selektiv einige Features des Add-Ins herauszufiltern. Weitere Informationen finden Sie unter Angeben von Office-Add-In-Anforderungen im einheitlichen Manifest für Microsoft 365.

extensions.runtimes

Optional – Array

Das extensions.runtimes Array konfiguriert die Sätze von Laufzeiten und Aktionen, die jeder Erweiterungspunkt verwenden kann.

Informationen zur Verwendung extensions.runtimesvon finden Sie unter Erstellen von Add-In-Befehlen, Konfigurieren der Runtime für einen Aufgabenbereich und Konfigurieren der Laufzeit für den Funktionsbefehl.

extensions.ribbons

Optional – Array

Die extensions.ribbons -Eigenschaft bietet die Möglichkeit, Add-In-Befehle (Schaltflächen und Menüelemente) zum Menüband der Microsoft 365-Anwendung hinzuzufügen. Die Menübanddefinition wird aus dem Array basierend auf den Anforderungen und der ersten Reihenfolge ausgewählt.

Informationen zur Verwendung extensions.ribbonsvon finden Sie unter Erstellen von Add-In-Befehlen, Konfigurieren der Benutzeroberfläche für den Aufgabenbereichbefehl und Konfigurieren der Benutzeroberfläche für den Funktionsbefehl.

extensions.autoRunEvents

Optional – Array

Die extensions.autoRunEvents -Eigenschaft definiert ereignisbasierte Aktivierungserweiterungspunkte.

extensions.alternates

Optional – Array

Die extensions.alternates -Eigenschaft wird verwendet, um bestimmte marktinterne Add-Ins auszublenden oder zu priorisieren, wenn Sie mehrere Add-Ins mit überlappenden Funktionen veröffentlicht haben.

dashboardCards

Optional – Array

Definiert eine Liste von Karten, die an eine Dashboard angeheftet werden können, z. B. Microsoft Viva Connections, um eine zusammengefasste Ansicht von App-Informationen bereitzustellen. Weitere Informationen zum Erstellen von Karten für Viva Connections Dashboard finden Sie unter Übersicht über botgestützte Erweiterungen für adaptive Karten.

Dieses Element ist ein Array von dashboardCard Elementen des Typs object.

dashboardCards.dashboardCard

Definiert eine einzelne Dashboard Karte und deren Eigenschaften.

dashboardCards.dashboardCard.icon

Definiert die Symboleigenschaften eines bestimmten Dashboard Karte.

dashboardCards.dashboardCard.contentSource

Definiert die Inhaltsquelle einer bestimmten Dashboard Karte.

dashboardCards.dashboardCard.contentSource.botConfiguration

Erstellen einer App-Manifestdatei

Wenn Ihre App über keine App-Manifestdatei verfügt, müssen Sie sie erstellen.

So erstellen Sie eine App-Manifestdatei:

1. Verwenden Sie das Beispielschema des App-Manifests , um eine .json-Datei zu erstellen.
2. Speichern Sie diese im Stammverzeichnis Ihres Projektordners als manifest.json.

{ 
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json", 
"manifestVersion": "1.12", 
"version": "1.0.0", 
"id": "{new GUID for this Teams app - not the Microsoft Entra App ID}", 
"developer": { 
"name": "Microsoft", 
"websiteUrl": "https://www.microsoft.com", 
"privacyUrl": "https://www.microsoft.com/privacy", 
"termsOfUseUrl": "https://www.microsoft.com/termsofuse" 
}, 

"name": { 
  "short": "Teams Auth SSO", 
  "full": "Teams Auth SSO" 
}, 


"description": { 
  "short": "Teams Auth SSO app", 
  "full": "The Teams Auth SSO app" 
}, 

"icons": { 
  "outline": "outline.png", 
  "color": "color.png" 
}, 

"accentColor": "#60A18E", 
"staticTabs": [ 
  { 
   "entityId": "auth", 
   "name": "Auth", 
   "contentUrl": "https://subdomain.example.com/Home/Index", 
   "scopes": [ "personal" ] 
  } 
], 

"configurableTabs": [ 
  { 
   "configurationUrl": "https://subdomain.example.com/Home/Configure", 
   "canUpdateConfiguration": true, 
   "scopes": [ 
   "team" 
    ] 
  } 
], 
"permissions": [ "identity", "messageTeamMembers" ], 
"validDomains": [ 
 "{subdomain or ngrok url}" 
], 
"webApplicationInfo": { 
  "id": "{Microsoft Entra AppId}", 
  "resource": "api://subdomain.example.com/{Microsoft Entra AppId}" 
}
} 

Siehe auch

• Grundlegendes zur Struktur von Microsoft Teams-Apps
• Aktivieren der App-Anpassung
• Lokalisieren IhrerApp
• Integrieren von Medienfunktionen
• Manifestschema der öffentlichen Entwicklervorschau-App