Obtener un recurso site
Espacio de nombres: microsoft.graph
Recupera las propiedades y relaciones de un recurso site. Un recurso site representa un sitio de grupo de SharePoint.
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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) | Sites.Read.All | Sites.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | Sites.Read.All | Sites.ReadWrite.All |
Solicitud HTTP
Obtener el sitio raíz del inquilino
Para obtener acceso al sitio de SharePoint de raíz dentro de un inquilino:
GET /sites/root
GET /sites/contoso.sharepoint.com
Obtener acceso a un sitio mediante la dirección URL relativa al servidor
Si tiene la dirección URL relativa al servidor de un recurso site, puede construir una solicitud de la manera siguiente:
GET /sites/{hostname}:/{server-relative-path}
Obtener acceso a un sitio de grupo
Para obtener acceso al sitio de grupo de un grupo:
GET /groups/{group-id}/sites/root
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Ejemplos
Ejemplo 1: Obtención de un sitio mediante el identificador de sitio
Solicitud
GET https://graph.microsoft.com/v1.0/sites/{site-id}
Respuesta
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
"isPersonalSite": false,
"displayName": "OneDrive Team Site",
"name": "1drvteam",
"createdDateTime": "2017-05-09T20:56:00Z",
"lastModifiedDateTime": "2017-05-09T20:56:01Z",
"webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}
Ejemplo 2: Obtención de un sitio por dirección URL relativa al servidor
Solicitud
GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{server-relative-path}
Respuesta
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
"displayName": "OneDrive Team Site",
"name": "1drvteam",
"createdDateTime": "2017-05-09T20:56:00Z",
"lastModifiedDateTime": "2017-05-09T20:56:01Z",
"webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}
Ejemplo 3: Obtención del sitio de un grupo
Solicitud
GET https://graph.microsoft.com/v1.0/groups/{group-id}/sites/root
Respuesta
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
"displayName": "OneDrive Team Site",
"name": "1drvteam",
"createdDateTime": "2017-05-09T20:56:00Z",
"lastModifiedDateTime": "2017-05-09T20:56:01Z",
"webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}
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