Partage via

Remplacer le décalage

  • Article

Espace de noms: microsoft.graph

Remplacez un shift existant.

Si le décalage spécifié n’existe pas, cette méthode retourne 404 Not found.

La durée d’une équipe ne peut pas être inférieure à 1 minute ou supérieure à 24 heures.

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) Schedule.ReadWrite.All Group.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Schedule.ReadWrite.All Non disponible.

Requête HTTP

PUT /teams/{teamId}/schedule/shifts/{shiftId}

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.
MS-APP-ACTS-AS UN ID d’utilisateur (GUID). Obligatoire uniquement si le jeton d’autorisation est un jeton d’application ; sinon, facultatif.

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.

Propriété Type Description
draftShift shiftItem Brouillons les modifications dans le shift. Les brouillons de modifications ne sont visibles que par les responsables. Les modifications sont visibles par les employés lorsqu’ils sont partagés, ce qui copie les modifications de draftShift vers la propriété sharedShift . draftOpenShift ou sharedOpenShift doit être null.
isStagedForDeletion Boolean Le décalage est marqué pour suppression, processus qui est finalisé lorsque la planification est partagée. Optional.
schedulingGroupId String ID du groupe de planification dont le shift fait partie. Obligatoire.
sharedShift shiftItem Version partagée de ce shift visible à la fois par les employés et les responsables. Mises à jour à la propriété sharedShift pour envoyer des notifications aux utilisateurs dans le client Teams. draftOpenShift ou sharedOpenShift doit être null.
userId String ID de l’utilisateur affecté au shift. Obligatoire.

Réponse

Si elle réussit, cette méthode renvoie un 204 No Content code de réponse et du contenu vide. Si la requête spécifie l’en-tête Prefer avec return=representation une préférence, cette méthode renvoie un 200 OK code de réponse et un objet shift dans le corps de la réponse.

Exemple

Demande

L’exemple suivant illustre une demande.

PUT https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts/{shiftId}
Content-type: application/json

{
  "userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d",
  "draftShift": {
    "displayName": null,
    "startDateTime": "2024-10-08T15:00:00Z",
    "endDateTime": "2024-10-09T00:00:00Z",
    "theme": "blue",
    "notes": null,
    "activities": []
  },
  "sharedShift": null,
  "isStagedForDeletion": false
}

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 204 No Content