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 todas las geografías GET /site/getAllSites
Enumerar subsitios para un sitio GET /sites/{site-id}/sites
Buscar sitios GET /sites?search={query}
Sitio de Archivo POST /sites/{site-id}/archive
Desarchivar sitio 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
Crear trabajo de procesamiento de documentos POST /sites/{site-id}/documentProcessingJobs
Operaciones de lista GET /sites/{site-id}/operations
Obtener 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 La fecha y hora en que se creó el sitio. Solo lectura. Heredado de baseItem.
description Cadena Texto descriptivo del sitio. Heredado de baseItem.
displayName Cadena El título completo del sitio. Solo lectura.
eTag String ETag para el sitio. Solo lectura. Heredado de baseItem.
id Cadena El identificador único del sitio. Solo lectura. Heredado de baseItem.
lastModifiedDateTime DateTimeOffset La fecha y hora en que se modificó por última vez el sitio. Solo lectura. Heredado de baseItem.
configuración regional Cadena La configuración de idioma del sitio.
lockState siteLockState El estado del sitio. Los valores posibles son: unlocked, lockedReadOnly, lockedNoAccess, lockedNoAdditions, unknownFutureValue
name Cadena El nombre del sitio. Heredado de baseItem.
ownerIdentityToResolve entrada de identidad El propietario del sitio 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, sts, unknownFutureValue.
webUrl Cadena La dirección URL del sitio que solo se puede proporcionar en el momento de la creación del sitio. Solo lectura. Heredado 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 visualización que tuvieron lugar en este sitio.
columns colección columnDefinition La colección de definiciones de columna reutilizables en listas en este sitio.
contentModels Recopilación de contentModel La colección de modelos de contenido aplicados a este sitio.
tipos de contenido Colección contentType 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 Los 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 La colección de extensiones abiertas definidas para este sitio. Admite valores NULL.
externalColumns colección columnDefinition 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 Colección baseItem Se utiliza para resolver cualquier elemento contenido en este sitio. Esta colección no se puede enumerar.
lists Colección de listas 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 Colección baseSitePage La colección de páginas de la lista baseSitePages de este sitio.
pageTemplates Colección pageTemplate La colección de plantillas de página de este sitio.
permissions Colección permission Permisos asociados a la plantilla del sitio. Admite un valor NULL.
papelera de reciclaje papelera de reciclaje Un contenedor para 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