Share via

Scopes-Element

  • Artikel

Enthält Berechtigungen, die das Add-In für eine externe Ressource benötigt, z. B. Microsoft Graph. Wenn Microsoft Graph die Ressource ist, verwendet AppSource das Scopes-Element, um ein Zustimmungsdialogfeld zu erstellen. Bei der Installation des Add-Ins aus dem Store wird der Benutzer aufgefordert, dem Add-In die angegebenen Berechtigungen für seine Microsoft Graph-Daten zu erteilen.

Add-In-Typ: Aufgabenbereich, E-Mail, Inhalt

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Inhalt 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

<Scopes ist ein untergeordnetes> Element des WebApplicationInfo-Elements im Manifest.

Untergeordnete Elemente

Element Erforderlich Beschreibung
<Bereich> Ja Der Name einer Berechtigung; Beispiel: Files.Read.All oder profile.

Beispiel

<OfficeApp>
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
    ...
    <WebApplicationInfo>
      <Id>12345678-abcd-1234-efab-123456789abc</Id>
      <Resource>api://contoso.com/12345678-abcd-1234-efab-123456789abc<Resource>
      <Scopes>
        <Scope>Files.Read.All</Scope>
        <Scope>offline_access</Scope>
        <Scope>openid</Scope>
        <Scope>profile</Scope>
      </Scopes>
    </WebApplicationInfo>
  </VersionOverrides>
...
</OfficeApp>