Guía de referencia

En este documento, se proporciona documentación de referencia detallada sobre el protocolo sin procesar (XML y HTTP) de la API de datos de Google Sites.

Este documento no contiene información sobre las bibliotecas cliente del lenguaje de programación. Para obtener información de referencia sobre la biblioteca cliente, consulta los vínculos de las secciones específicas del lenguaje de programación de la guía del programador.

Audience

Este documento está destinado a programadores que desean escribir aplicaciones cliente que pueden interactuar con Google Sites.

Es un documento de referencia; se asume que comprendes los conceptos presentados en la guía de protocolo y las ideas generales detrás del protocolo de API de datos de Google.

Tipos de feed de Google Sites

La API de datos de Google Sites proporciona los siguientes tipos de feeds:

Feed de actividad

El feed de actividad es un feed que contiene descripciones de todas las actividades de un sitio.

El URI GET de este feed para un sitio dentro de un dominio en particular es:

https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]

domainName es un sitio o un dominio de G Suite.

siteName es el nombre del sitio tal como aparece en la URL de la página de destino del sitio: http://sites.google.com/a/domainName/siteName/.

Todas las solicitudes a este feed se deben autenticar.

Tipos de solicitudes compatibles: GET

Canal de contenido

El canal de contenido es un feed que incluye el contenido actual y editable del sitio.

El URI GET de este feed para un sitio dentro de un dominio en particular es:

https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]

domainName es un sitio o un dominio de G Suite.

siteName es el nombre del sitio tal como aparece en la URL de la página de destino del sitio: http://sites.google.com/a/domainName/siteName.

Las solicitudes a este feed pueden requerir autenticación o no, según la configuración del sitio (publicada).

Tipos de solicitudes compatibles: GET, POST, PUT, DELETE

Además de los parámetros de búsqueda estándares de la API de datos, la API de datos de sitios permite los siguientes parámetros opcionales que emiten una solicitud de GET mediante el canal de contenido:

Parámetro Descripción Tipo Notas
ancestor Solo solicita entradas que tengan el principal especificado. string Proporciona el ID de la entrada principal deseada. Por ejemplo: 0123456789. Muestra todas las entradas que tienen el principal especificado como superior, uno superior, etc.
include-deleted Especifica si se deben incluir las entradas eliminadas. boolean Los valores posibles son true o false. El valor predeterminado es false.
include-draft Especifica si se deben incluir borradores de entradas. boolean Los valores posibles son true o false. El valor predeterminado es false. Debes ser el propietario o el autor del borrador para verlo.
kind Especifica el tipo de entradas de contenido que se mostrarán. Estas siguen el tipo de página dentro de Google Sites. lista de strings separadas por comas Los valores posibles son announcement, announcementspage, attachment, comment, filecabinet, listitem, listpage, webpage, webattachment y template.
parent Solo solicita entradas que tengan el elemento superior especificado. string Proporciona el ID de la entrada principal. Por ejemplo: 0123456789.
path Solicita contenido en una jerarquía de páginas determinada string Es la ruta de acceso a una subpágina dentro de un sitio de la que se debe recuperar contenido. Por ejemplo: path=/path/to/page.

Feed de revisión

El feed de revisión es un feed que contiene revisiones históricas del contenido del sitio.

El URI GET de este feed para un sitio dentro de un dominio en particular es:

https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]

domainName es un sitio o un dominio de G Suite.

siteName es el nombre del sitio tal como aparece en la URL de la página de destino del sitio: http://sites.google.com/a/domainName/siteName.

Todas las solicitudes a este feed se deben autenticar.

Tipos de solicitudes compatibles: GET

Feed del sitio

El feed del sitio se puede usar para enumerar los sitios de Google de los que un usuario es propietario o tiene permisos de visualización. También se puede usar para crear sitios nuevos, copiar un sitio o modificar el nombre de un sitio existente.

El URI del feed para la lista de sitios es el siguiente:

https://sites.google.com/feeds/site/domainName/[siteName]

domainName es un sitio o un dominio de G Suite.

Todas las solicitudes a este feed se deben autenticar.

Tipos de solicitudes compatibles: GET, POST, PUT

El feed del sitio admite los siguientes parámetros (opcional) cuando emite una solicitud GET para enumerar sitios:

Parámetro Descripción Tipo Notas
include-all-sites Enumera todos los sitios que, al menos, el usuario puede ver en el dominio de G Suite. boolean Este parámetro solo se aplica cuando se enumeran sitios para un dominio de G Suite. Los valores posibles son true o false. El valor predeterminado es false.
with-mappings Incluye las asignaciones de direcciones web en una entrada del sitio. boolean Los valores posibles son true o false. El valor predeterminado es false.

Feed de LCA

El feed de LCA se puede usar para enumerar o modificar los permisos de uso compartido (LCA) de un sitio de Google.

El URI del feed para la lista de sitios es el siguiente:

https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]

domainName es un sitio o un dominio de G Suite.

Todas las solicitudes a este feed se deben autenticar.

Tipos de solicitudes compatibles: GET, POST, PUT, DELETE

Referencia de los parámetros de búsqueda de Google Sites

Parámetros de consulta admitidos desde el protocolo de la API de datos de Google:

  • max-results
  • published-max (solo canal de contenido)
  • published-min (solo canal de contenido)
  • start-index
  • updated-max
  • updated-min
  • q (consultas de texto completas)

Consulte cada feed para obtener una lista de los parámetros específicos de ese feed.

Volver al principio