Mettre à jour userConfiguration

Espace de noms: microsoft.graph

Mettre à jour les propriétés d’un objet userConfiguration .

Autorisations

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

Requête HTTP

PATCH /me/mailFolders/{mailFolderId}/userConfigurations/{userConfigurationId}
PATCH /users/{usersId}/mailFolders/{mailFolderId}/userConfigurations/{userConfigurationId}

En-têtes de demande

Corps de la demande

Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.

Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.

Réponse

En cas de réussite, cette méthode renvoie un 200 OK code de réponse et un objet userConfiguration mis à jour dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

Remarque : L’objet structuredData entier est mis à jour.

PATCH https://graph.microsoft.com/beta/me/mailFolders/inbox/userConfigurations/MyApp
Content-Type: application/json

{
  "structuredData": [
    {
      "keyEntry":
      {
        "type": "string",
        "values": [
          "name"
        ]
      },
      "valueEntry":
      {
        "type": "string",
        "values": [
          "Snow"
        ]
      }
    }
  ]
}

const options = {
	authProvider,
};

const client = Client.init(options);

const userConfiguration = {
  structuredData: [
    {
      keyEntry: 
      {
        type: 'string',
        values: [
          'name'
        ]
      },
      valueEntry: 
      {
        type: 'string',
        values: [
          'Snow'
        ]
      }
    }
  ]
};

await client.api('/me/mailFolders/inbox/userConfigurations/MyApp')
	.version('beta')
	.update(userConfiguration);

Réponse

L’exemple suivant illustre la 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/beta/$metadata#users('f42c50f8-1300-48a0-93d4-6481acda7efb')/mailFolders('inbox')/userConfigurations/$entity",
  "structuredData": [
    {
      "@odata.type": "microsoft.graph.structuredDataEntry"
    }
  ]
}