List transitiveMemberOf
Espacio de nombres: microsoft.graph
Obtenga los grupos de los que es miembro este contacto organizativo . La solicitud de API es transitiva y devuelve todos los grupos de los que el contacto de la organización es miembro anidado.
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
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Tipo de permiso | Permisos (de menos a más privilegiados) |
---|---|
Delegado (cuenta profesional o educativa) | OrgContact.Read.All y Group.Read.All, Directory.Read.All |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | OrgContact.Read.All y Group.Read.All, Directory.Read.All |
Solicitud HTTP
GET /contacts/{id}/transitiveMemberOf
Parámetros de consulta opcionales
Este método es compatible con los parámetros de consulta de OData para ayudar a personalizar la respuesta, incluyendo $select
, $search
, y $count
. La conversión de OData también está habilitada, por ejemplo, puede convertir para obtener solo los grupos de los que el contacto es miembro. Puede usar $search
en la propiedad displayName. Los tamaños de página predeterminado y máximo son 100 y 999 objetos, respectivamente.
Encabezados de solicitud
Encabezado | Valor |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Aceptar | application/json |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK
y una colección de objetos directoryObject en el cuerpo de la respuesta.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/contacts/e63333f5-3d11-4026-8fe3-c0f7b044dd3a/transitiveMemberOf
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 200 OK
Content-type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.group",
"id": "id-value",
"createdDateTime": null,
"description": "All users at the company",
"displayName": "All Users",
"groupTypes": [],
"mailEnabled": false,
"securityEnabled": true,
}
]
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de