Scopes-Element

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 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 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 reinen Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

• IdentityAPI 1.3

<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 Profil. Die möglichen Werte sind die Berechtigungen, die Sie beim Registrieren des Add-Ins in microsoft Identity Platform festlegen. Weitere Informationen finden Sie unter 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>