Compartir a través de


Actualizar calendario

Espacio de nombres: microsoft.graph

Actualiza las propiedades del objeto de calendario. El calendario puede ser el de un usuario o el calendario predeterminado de un grupo de Microsoft 365.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permisos

Según el tipo de calendario en el que se encuentre el evento y el tipo de permiso (delegado o aplicación) que se solicite, se necesita uno de los siguientes permisos para llamar a esta API: Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Calendario Delegado (cuenta profesional o educativa) Delegado (cuenta de Microsoft personal) Aplicación
calendario de usuario Calendars.ReadWrite Calendars.ReadWrite Calendars.ReadWrite
calendario de grupo Group.ReadWrite.All No admitida. No admitida.

Solicitud HTTP

calendar predeterminado de un usuario o grupo.

PATCH /me/calendar
PATCH /users/{id | userPrincipalName}/calendar
PATCH /groups/{id}/calendar

calendar de un usuario del calendarGroup predeterminado.

PATCH /me/calendars/{id}
PATCH /users/{id | userPrincipalName}/calendars/{id}

calendar de un usuario de un calendarGroup específico.

PATCH /me/calendarGroups/{id}/calendars/{id}
PATCH /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos relevantes que deben actualizarse. Las propiedades existentes que no se incluyan en el cuerpo de la solicitud mantendrán los valores anteriores o se recalcularán según los cambios efectuados en otros valores de propiedad. Para obtener el mejor rendimiento no debe incluir valores existentes que no hayan cambiado.

Propiedad Tipo Descripción
color String Especifica el tema de color para distinguir el calendario de otros calendarios en una interfaz de usuario. Los valores de propiedad son: LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1
isDefaultCalendar Booleano “True” si el calendario es el predeterminado del usuario; de lo contrario, “false”.
name String El nombre del calendario.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y el objeto calendar actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se actualiza el nombre del calendario predeterminado del usuario que ha iniciado sesión.

PATCH https://graph.microsoft.com/v1.0/me/calendar
Content-type: application/json

{
  "name": "Social events"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta. Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.

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

{
    "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#me/calendars/$entity",
    "@odata.id":"https://graph.microsoft.com/v1.0/users('266efe5a-0fd7-4edd-877b-b2d1e561f193@ae01a323-3934-4475-a32d-af1274312bb0')/calendars('AAMkADJmMVAAA=')",
    "id":"AAMkADJmMVAAA=",
    "name":"Social events",
    "color":"auto",
    "isDefaultCalendar":false,
    "changeKey":"DxYSthXJXEWwAQSYQnXvIgAAIxGttg==",
    "canShare":true,
    "canViewPrivateItems":true,
    "hexColor": "",
    "canEdit":true,
    "allowedOnlineMeetingProviders": [
                "teamsForBusiness"
            ],
    "defaultOnlineMeetingProvider": "teamsForBusiness",
    "isTallyingResponses": true,
    "isRemovable": false,
    "owner":{
        "name":"Samantha Booth",
        "address":"samanthab@contoso.com"
    }
}