Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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": [
]
}