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-resultspublished-max(solo canal de contenido)published-min(solo canal de contenido)start-indexupdated-maxupdated-minq(consultas de texto completas)
Consulte cada feed para obtener una lista de los parámetros específicos de ese feed.