tipo de recurso site

Artículo
10/14/2024

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
Plantillas de página de lista	GET /sites/{site-id}/pageTemplates/microsoft.graph.pageTemplate
Enumerar sitios raíz	GET /sites?filter=root ne null&select=siteCollection,webUrl
Enumerar sitios en distintas zonas geográficas	GET /site/getAllSites
Enumerar subsitios de un sitio	GET /sites/{site-id}/sites
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
Creación de un trabajo de procesamiento de documentos	POST /sites/{site-id}/documentProcessingJobs
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.
contentModels	contentModel (colección)	Colección de modelos de contenido aplicados a 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.
documentProcessingJobs	colección documentProcessingJob	Trabajos de procesamiento de documentos que se ejecutan en 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.
pageTemplates	colección pageTemplate	Colección de plantillas de página en 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"
}

Compartir a través de