Guía de referencia

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

Este documento no contiene información sobre las bibliotecas cliente de lenguajes de programación. Para obtener información de referencia de 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 los programadores que desean escribir aplicaciones cliente que puedan interactuar con Google Sites.

Es un documento de referencia que supone que comprendes los conceptos que se presentan en la guía de protocolos y las ideas generales detrás del protocolo de las APIs de datos de Google.

Tipos de feeds de Google Sites

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

Feed de actividad

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

El URI de 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 puede ser "site" 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 deben autenticarse.

Tipos de solicitudes admitidos: GET

Canal de contenido

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

El URI de 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 puede ser "site" 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 o no autenticación, según la configuración (publicada) del sitio.

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

Además de los parámetros de consulta estándar de la API de Data, la API de Sites Data permite los siguientes parámetros opcionales para emitir solicitudes GET con el feed de contenido:

Parámetro Descripción Tipo Notas
ancestor Solicita solo las entradas que tienen el principal especificado. string Proporciona el ID de la entrada principal deseada. Por ejemplo: 0123456789. Devuelve todas las entradas que tienen el elemento principal especificado como elemento superior, elemento superior del elemento superior, etcétera.
include-deleted Especifica si se deben incluir las entradas borradas. booleano Los valores posibles son true o false. El valor predeterminado es false.
include-draft Especifica si se deben incluir las entradas de borrador. booleano Los valores posibles son true o false. El valor predeterminado es false. Para ver el borrador, debes ser su propietario o autor.
kind Especifica los tipos de entradas de contenido que se devolverán. Estos 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, template.
parent Solicita solo las entradas que tienen el elemento principal 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 para recuperar contenido. Por ejemplo: path=/path/to/page.

Feed de revisión

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

El URI de 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 puede ser "site" 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 deben autenticarse.

Tipos de solicitudes admitidos: GET

Feed del sitio

El feed de sitios se puede usar para enumerar los sitios de Google Sites que posee un usuario o para los que 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 ficha de Sites es el siguiente:

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

domainName puede ser "site" o un dominio de G Suite.

Todas las solicitudes a este feed deben autenticarse.

Tipos de solicitudes admitidos: GET, POST, PUT

El feed de sitios admite los siguientes parámetros (opcionales) cuando se emite una solicitud de GET para sitios de fichas:

Parámetro Descripción Tipo Notas
include-all-sites Enumera todos los sitios que el usuario puede ver, al menos, en el dominio de G Suite. booleano 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. booleano 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 ficha de Sites es el siguiente:

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

domainName puede ser "site" o un dominio de G Suite.

Todas las solicitudes a este feed deben autenticarse.

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

Referencia de los parámetros de consulta de Google Sites

Parámetros de consulta admitidos del protocolo de la API de Google Data:

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

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

Volver al principio