tipo de recurso site

  • Artículo

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.

El recurso site proporciona metadatos y relaciones para un sitio de SharePoint.

Métodos

Método Ruta de acceso a REST
Obtener sitio raíz GET /sites/root
Obtener sitio GET /sites/{site-id}
Obtener sitio por su ruta de acceso GET /sites/{hostname}:/{site-path}
Obtener sitio para un grupo GET /groups/{group-id}/sites/root
Obtener análisis GET /sites/{site-id}/analytics
Obtener actividades por intervalo GET /sites/{site-id}/getActivitiesByInterval
Enumerar páginas GET /sites/{site-id}/pages
Enumerar sitios raíz GET /sites?filter=root ne null&select=siteCollection,webUrl
Enumerar sitios en distintas zonas geográficas GET /site/getAllSites
Buscar sitios GET /sites?search={query}
Seguir el sitio POST /users/{user-id}/followedSites/add
Dejar de seguir el sitio POST /users/{user-id}/followedSites/remove
Lista de sitios seguidos GET /me/followedSites
Obtener permiso GET /sites/{site-id}/permissions/{permission-id}
Enumerar permisos GET /sites/{site-id}/permissions
Crear permisos POST /sites/{site-id}/permissions
Eliminar permiso DELETE /sites/{site-id}/permissions/{permission-id}
Actualizar permiso PATCH /sites/{site-id}/permissions/{permission-id}
Tipos de contenido de lista GET /sites/{site-id}/contentTypes
Crear contentType POST /sitios/{site-id}/contentTypes
List columns GET /sites/{site-id}/columns
Crear columna POST /sitios/{site-id}/columnas
Operaciones de lista GET /sites/{site-id}/operations
Obtener la configuración del sitio GET /sites/{site-id}/settings
Obtener delta GET /sites/delta

Propiedades

Propiedad Tipo Descripción
id string El identificador único del elemento. Solo lectura.
createdDateTime DateTimeOffset La fecha y la hora de creación del elemento. Solo lectura.
description string Texto descriptivo del sitio.
eTag string ETag para el elemento. Solo lectura.
displayName cadena El título completo del sitio. Solo lectura.
lastModifiedDateTime DateTimeOffset Fecha y hora de la última modificación del elemento. Solo lectura.
name string Nombre o título del elemento.
root root Si está presente, proporciona el sitio raíz en la colección de sitios. Solo lectura.
settings siteSettings La configuración de este sitio. Solo lectura.
sharepointIds sharepointIds Devuelve los identificadores útiles para la compatibilidad con REST de SharePoint. Solo lectura.
siteCollection siteCollection Proporciona detalles sobre la colección de sitios del sitio. Solo disponible en el sitio raíz. Solo lectura.
webUrl string (url) Dirección URL que muestra el elemento en el explorador. Solo lectura.

Propiedad id

Un sitio se identifica con un id. único compuesto por los siguientes valores:

  • Nombre de host de la colección de sitios (contoso.sharepoint.com)
  • Identificador único (GUID) de la colección de sitios
  • Identificador único (GUID) del sitio

El identificador root siempre hace referencia al sitio raíz de un destino determinado, de la siguiente manera:

  • /sites/root: El sitio raíz del inquilino.
  • /groups/{group-id}/sites/root: Sitio del grupo.

Relaciones

Relación Tipo Descripción
analytics itemAnalytics Análisis sobre las actividades de vista que tuvieron lugar en este sitio.
columns columnDefinition (colección) La colección de definiciones de columna reutilizables en listas en este sitio.
contentTypes contentType (colección) La colección de tipos de contenido definidos para este sitio.
drive drive La unidad predeterminada (biblioteca de documentos) para este sitio.
drives Colección drive La colección de unidades (bibliotecas de documentos) de este sitio.
externalColumns columnDefinition (colección) Colección de definiciones de columna disponibles en el sitio al que se hace referencia desde los sitios de la jerarquía primaria del sitio actual.
items baseItem (colección) Se utiliza para resolver cualquier elemento contenido en este sitio. Esta colección no se puede enumerar.
lists colección list La colección de listas en este sitio.
operations colección richLongRunningOperation Colección de operaciones de larga ejecución para el sitio.
páginas baseSitePage (colección) Colección de páginas de la lista baseSitePages de este sitio.
permissions Colección permission Permisos asociados a la plantilla del sitio. Admite un valor NULL.
recycleBin recycleBin Contenedor de una colección de recursos recycleBinItem en este sitio.
sites Colección site La colección de subsitios de este sitio.
termStore microsoft.graph.termStore.store TermStore en este sitio.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

El recurso site deriva de baseItem y hereda sus propiedades.

{
  "displayName": "string",
  "id": "string",
  "root": { "@odata.type": "microsoft.graph.root" },
  "settings": { "@odata.type": "microsoft.graph.sitesettings" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "siteCollection": {"@odata.type": "microsoft.graph.siteCollection"},

  /* relationships */
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "externalColumns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "drives": [ { "@odata.type": "microsoft.graph.drive" }],
  "items": [ { "@odata.type": "microsoft.graph.baseItem" }],
  "lists": [ { "@odata.type": "microsoft.graph.list" }],
  "permissions": [ { "@odata.type": "microsoft.graph.permission" }],
  "sites": [ { "@odata.type": "microsoft.graph.site"} ],
  "termStore": { "@odata.type": "microsoft.graph.termStore.store" },

  /* inherited from baseItem */
  "createdDateTime": "datetime",
  "description": "string",
  "eTag": "string",
  "lastModifiedDateTime": "datetime",
  "name": "string",
  "webUrl": "url"
}