Partager via


Créer un agreementFileLocalization

Espace de noms: microsoft.graph

Créez un fichier de contrat localisé.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Agreement.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Non prise en charge. Non prise en charge.

Requête HTTP

POST /agreements/{agreementsId}/files

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet agreementFileLocalization .

Vous pouvez spécifier les propriétés suivantes lors de la création d’un agreementFileLocalization.

Propriété Type Description
displayName Chaîne Nom d’affichage localisé du fichier de stratégie d’un contrat. Le nom d’affichage localisé s’affiche aux utilisateurs finaux qui affichent le contrat.
fileData agreementFileData Données qui représentent le document PDF des conditions d’utilisation.
fileName Chaîne Nom du fichier d’accord (par exemple, TOU.pdf).
isDefault Valeur booléenne Si aucune des langues ne correspond à la préférence du client, indique s’il s’agit du fichier de contrat par défaut. Si aucun des fichiers n’est marqué comme fichier par défaut, le premier est traité comme étant la valeur par défaut. En lecture seule.
isMajorVersion Valeur booléenne Indique si le fichier de contrat est une mise à jour de version majeure. Les mises à jour de version principale invalident les acceptations du contrat sur la langue correspondante.
language Chaîne Langue du fichier de contrat au format « languagecode2-country/regioncode2 ». « languagecode2 » est un code à deux lettres minuscules dérivé de la norme ISO 639-1, tandis que « country/regioncode2 » est dérivé de la norme ISO 3166 et se compose généralement de deux lettres majuscules ou d’une balise de langue BCP-47. Par exemple, l’anglais américain est en-US.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet agreementFileLocalization dans le corps de la réponse.

Exemples

Demande

POST https://graph.microsoft.com/v1.0/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"
    }
}

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$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/"
    }
}