Scopes-Element

Enthält Berechtigungen, die das Add-In für eine externe Ressource, wie z. B. Microsoft Graph, benötigt. Wenn Microsoft Graph die Ressource ist, verwendet Microsoft Marketplace das Element, um ein Zustimmungsdialogfeld zu erstellen. Wenn Benutzer das Add-In aus dem Marketplace installieren, werden sie aufgefordert, dem Add-In die angegebenen Berechtigungen für die Microsoft Graph-Daten des Benutzers zu erteilen.

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

Nur in diesen VersionOverrides-Schemas gültig:

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

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-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; beispielsweise "Files". Read.All oder Profil. Die möglichen Werte sind die Berechtigungen, die Sie festlegen, wenn Sie das Add-In in der Microsoft Identity Platform registrieren. Siehe Hinzufügen von Microsoft Graph-Berechtigungen.

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>