Compartir a través de

tipo de recurso site

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
Crear POST /sites
Get GET /sites/{site-id}
Obtener sitio raíz GET /sites/root
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}
Archivo sitio POST /sites/{site-id}/archive
Sitio noarchivo POST /sites/{site-id}/unarchive
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
Obtención del estado de la operación GET /sites/getOperationStatus(operationId='{siteOperationId}')
Obtener la configuración del sitio GET /sites/{site-id}/settings
Obtener delta GET /sites/delta
Extensiones abiertas
Crear extensión abierta POST /sites/{site-id}/extensions
Obtener extensión abierta GET /sites/{site-id}/extensions
Actualizar extensión abierta PATCH /sites/{site-id}/extensions
Eliminar extensión abierta DELETE /sites/{site-id}/extensions

Propiedades

Propiedad Tipo Descripción
createdDateTime DateTimeOffset Fecha y hora en que se creó el sitio. Solo lectura. Se hereda de baseItem.
description Cadena Texto descriptivo del sitio. Se hereda de baseItem.
displayName Cadena El título completo del sitio. Solo lectura.
eTag String ETag para el sitio. Solo lectura. Se hereda de baseItem.
id Cadena Identificador único del sitio. Solo lectura. Se hereda de baseItem.
lastModifiedDateTime DateTimeOffset Fecha y hora en que se modificó por última vez el sitio. Solo lectura. Se hereda de baseItem.
configuración regional Cadena La configuración de idioma del sitio.
lockState siteLockState Estado del sitio. Los valores posibles son: unlocked, lockedReadOnly, lockedNoAccess, , , lockedNoAdditionsunknownFutureValue
name Cadena Nombre del sitio. Se hereda de baseItem.
ownerIdentityToResolve identityInput Propietario del sitio que se proporcionará solo en el momento de la creación del sitio.
root root Si está presente, proporciona el sitio raíz en la colección de sitios. Solo lectura.
configuración siteSettings La configuración de este sitio. Solo lectura.
shareByEmailEnabled Booleano Determina si el sitio y su contenido se pueden compartir por correo electrónico.
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.
template siteTemplateType Especifica la plantilla aplicada al sitio. Los valores posibles son: sitepagepublishing, group, sts y unknownFutureValue
webUrl Cadena Dirección URL del sitio que solo se puede proporcionar en el momento de la creación del sitio. Solo lectura. Se hereda de baseItem.

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.
extensions Colección Extension Colección de extensiones abiertas definidas para este sitio. Admite valores NULL.
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",
  "locale": "String",
  "lockState": "String",
  "ownerIdentityToResolve": {"@odata.type": "microsoft.graph.identityInput"},
  "root": { "@odata.type": "microsoft.graph.root" },
  "settings": { "@odata.type": "microsoft.graph.sitesettings" },
  "shareByEmailEnabled": "Boolean",
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "siteCollection": {"@odata.type": "microsoft.graph.siteCollection"},
  "template": "String",

  /* relationships */
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "extensions": [ { "@odata.type": "microsoft.graph.extension" }],
  "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"
}
  • Last updated on