Freigeben über


Create agreementFileLocalization

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Erstellen Sie eine neue lokalisierte Vertragsdatei.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Agreement.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Nicht unterstützt Nicht unterstützt

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra Rolle zugewiesen werden. Der Administrator für bedingten Zugriff ist die Rolle mit den geringsten Berechtigungen, die für diesen Vorgang unterstützt wird. Sicherheitsadministrator ist eine privilegiertere Rolle, die für diesen Vorgang unterstützt wird.

HTTP-Anforderung

POST /agreements/{agreementsId}/files

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des AgreementFileLocalization-Objekts an.

Sie können die folgenden Eigenschaften angeben, wenn Sie eine vereinbarungFileLocalization erstellen.

Eigenschaft Typ Beschreibung
displayName Zeichenfolge Lokalisierter Anzeigename der Richtliniendatei einer Vereinbarung. Der lokalisierte Anzeigename wird Endbenutzern angezeigt, die die Vereinbarung anzeigen.
fileData agreementFileData Daten, die das PDF-Dokument mit den Nutzungsbedingungen darstellen.
fileName Zeichenfolge Name der Vertragsdatei (z. B. TOU.pdf).
isDefault Boolean Wenn keine der Sprachen mit der Clienteinstellung übereinstimmt, gibt an, ob dies die Standardvereinbarungsdatei ist. Wenn keine der Dateien als Standard markiert ist, wird die erste datei als Standard behandelt. Schreibgeschützt.
isMajorVersion Boolean Gibt an, ob es sich bei der Vertragsdatei um ein Hauptversionsupdate handelt. Aktualisierungen der Hauptversion ungültig die Zustimmungen der Vereinbarung in der entsprechenden Sprache.
language Zeichenfolge Die Sprache der Vertragsdatei im Format "languagecode2-country/regioncode2". "languagecode2" ist ein aus ISO 639-1 abgeleiteter Kleinbuchstabencode, während "country/regioncode2" von ISO 3166 abgeleitet ist und in der Regel aus zwei Großbuchstaben oder einem BCP-47-Sprachtag besteht. Beispielsweise ist en-USUS-Englisch .

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein agreementFileLocalization-Objekt im Antworttext zurückgegeben.

Beispiele

Anforderung

POST https://graph.microsoft.com/beta/identityGovernance/termsOfUse/agreements/94410bbf-3d3e-4683-8149-f034e55c39dd/files
Content-Type: application/json

{
    "fileName": "Contoso ToU for guest users (French)",
    "language": "fr-FR",
    "isDefault": false,
    "isMajorVersion": false,
    "displayName": "Contoso ToU for guest users (French)",
    "fileData": {
        "data": "base64JVBERi0xLjUKJb/3ov4KNCAwIG9iago8PCAvTGluZWFyaX//truncated-binary-data"
    }
}

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/termsOfUse/agreements('94410bbf-3d3e-4683-8149-f034e55c39dd')/files/$entity",
    "id": "90d1723c-52c1-40e3-a51a-da99a82c0327",
    "fileName": "Contoso ToU for guest users (French)",
    "displayName": "Contoso ToU for guest users (French)",
    "language": "fr-FR",
    "isDefault": false,
    "isMajorVersion": false,
    "createdDateTime": "2022-03-04T14:38:22.8292386Z",
    "fileData": {
        "data": "base64JVBERi0xLjUKJb/"
    }
}