Aktualisieren von "teamsApp"

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Aktualisieren Sie eine zuvor im Microsoft Teams-App-Katalog veröffentlichte App. Um eine App zu aktualisieren, muss die distributionMethod-Eigenschaft für die App auf organization.

Diese API aktualisiert speziell eine App, die im App-Katalog Ihrer Organisation (dem Mandanten-App-Katalog) veröffentlicht wurde.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Hinweis: Nur globale Administratoren können diese API aufrufen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	AppCatalog.Submit, AppCatalog.ReadWrite.All, Directory.ReadWrite.All**
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

Hinweis: Mit ** markierte Berechtigungen werden nur für die Abwärtskompatibilität unterstützt. Es wird empfohlen, Ihre Lösungen so zu aktualisieren, dass sie eine alternative Berechtigung verwenden, die in der vorherigen Tabelle aufgeführt ist, und diese Berechtigungen in Zukunft nicht mehr verwenden.

HTTP-Anforderung

POST /appCatalogs/teamsApps/{id}/appDefinitions

Abfrageparameter

Eigenschaft	Typ	Beschreibung
requiresReview	Boolean	Dieser optionale Abfrageparameter löst den App-Überprüfungsprozess aus. Benutzer mit Administratorrechten können Apps übermitteln, ohne eine Rezension auszulösen. Wenn Benutzer vor der Veröffentlichung eine Überprüfung anfordern möchten, müssen sie auf true.requiresReview Ein Benutzer mit Administratorrechten kann den Wert false nicht festlegen requiresReview oder festlegen, und die App wird als genehmigt betrachtet und sofort veröffentlicht.

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich.
Content-Type	application/zip. Erforderlich.

Anforderungstext

Fügen Sie im Anforderungstext eine Teams ZIP-Manifestnutzlast ein. Ausführliche Informationen finden Sie unter "Erstellen eines App-Pakets".

Hinweis: Verwenden Sie die ID, die vom Aufruf der veröffentlichten Listen-Apps zurückgegeben wird , um auf die App zu verweisen, die Sie aktualisieren möchten. Verwenden Sie nicht die ID aus dem Manifest des ZIP-App-Pakets.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Beispiel 1: Aktualisieren einer Anwendung, die zuvor im Microsoft Teams App-Katalog veröffentlicht wurde

Anforderung

POST https://graph.microsoft.com/beta/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8/appDefinitions
Content-type: application/zip

[Zip file containing a Teams app package]

Ausführliche Informationen zur zip-Datei Teams Anwendung finden Sie unter Erstellen eines App-Pakets.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiel 2: Aktualisieren einer neuen Version einer vorhandenen App für die Administratorüberprüfung vor der Veröffentlichung im aktuellen Mandantenkatalog

Anforderung

HTTP

POST https://graph.microsoft.com/beta/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions?requiresReview=true
Content-type: application/zip

[Zip file containing a Teams app package]

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const teamsAppDefinition = [Zip file containing a Teams app package];

await client.api('/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions?requiresReview=true')
    .version('beta')
    .post(teamsAppDefinition);

Wichtig

Microsoft Graph SDKs verwenden standardmäßig die Version 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Betaversion verfügbar sind. Ausführliche Informationen zum Zugreifen auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und das Schlüssel-Wert-Paar publishingStatezurück: submitted im Antworttext. Siehe "teamsappdefinition".

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/beta/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions/MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#appDefinition",
    "@odata.etag": "158749010",
    "id": "MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==",
    "teamsAppId": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
    "displayName": "Test app",
    "version": "1.0.11",
    "azureADAppId": "a651cc7d-ec54-4fb2-9d0e-2c58dc830b0b",
    "requiredResourceSpecificApplicationPermissions":[
         "ChannelMessage.Read.Group",
         "Channel.Create.Group",
         "Tab.ReadWrite.Group",
         "Member.Read.Group"
    ],
    "publishingState": "submitted",
    "lastModifiedDateTime": "2020-02-10 22:48:33.841",
}