Crear PlannerRosterMember

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Agregar un miembro al objeto plannerRoster .

Disponibilidad de API

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Tasks.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Tasks.ReadWrite.All No disponible.

Solicitud HTTP

POST /planner/rosters/{plannerRosterId}/members

Encabezados de solicitud

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

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto plannerRosterMember .

En la tabla siguiente se enumeran las propiedades que se requieren para crear el plannerRosterMember.

Propiedad Tipo Description
roles Colección de cadenas Otros roles asignados al usuario. Opcional. Actualmente, no hay otros roles disponibles para los usuarios.
tenantId Cadena Identificador del inquilino al que pertenece el usuario. Opcional. Actualmente, los miembros de la lista no pueden ser de espacios empresariales diferentes.
userId Cadena Identificador del usuario.

Respuesta

Si tiene éxito, este método devuelve un código de 201 Created respuesta y un objeto plannerRosterMember en el cuerpo de la respuesta.

Este método devuelve un 403 Forbidden código de respuesta si la etiqueta de confidencialidad de la lista no permite la adición de invitados y la solicitud agrega invitados a plannerRoster. Se produce un error en la solicitud y la propiedad code del tipo de recurso de error tiene el valor addingGuestUsersProhibitedByLabel.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/planner/rosters/6519868f-868f-6519-8f86-19658f861965/members
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.plannerRosterMember",
  "userId": "String"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.plannerRosterMember",
  "id": "670095cd-95cd-6700-cd95-0067cd950067",
  "userId": "5ba84f7a-aa11-4a51-a298-9f2c7ec6bb38",
  "roles": [
  ]
}