Guía de referencia

En este documento se brinda documentación de referencia detallada del protocolo sin procesar (XML y HTTP) para la API de datos de Google Sites.

Este documento no contiene información acerca de las bibliotecas cliente en el 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 para desarrolladores.

Público

Este documento está dirigido a programadores que desean crear aplicaciones cliente que puedan interactuar con Google Sites.

Es un documento de referencia; en él se supone 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 aquel 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 el siguiente:

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 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 admitidos: GET

Canal de contenido

El feed de contenido es aquel 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 el siguiente:

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 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 (publicado).

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

Además de los parámetros de consulta estándar de la API de datos, la API de Sites permite los siguientes parámetros opcionales que emiten una solicitud GET a través del feed de contenido:

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

Feed de revisiones

El feed de revisiones 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 el siguiente:

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 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 admitidos: GET

Feed del sitio

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

El URI de feed para la ficha de Sites 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 admitidos: 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 puede ver el usuario del dominio de G Suite. boolean Este parámetro solo se aplica cuando se muestran 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 puede utilizarse para enumerar o modificar los permisos de uso compartido (LCA) de un sitio de Google.

El URI de feed para la ficha de Sites 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 admitidos: GET, POST, PUT, DELETE

Referencia de los parámetros de consulta de Google Sites

Parámetros de consulta compatibles del protocolo API de datos de Google:

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

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

Volver al principio