En este documento, se proporciona documentación de referencia detallada para 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 de lenguaje de programación. Para obtener información de referencia de la biblioteca cliente, consulta los vínculos de las secciones específicas de cada lenguaje de programación de la guía para desarrolladores.
Público
Este documento está dirigido a programadores que deseen escribir aplicaciones cliente que puedan interactuar con Google Sites.
Es un documento de referencia y en él se supone que comprendes los conceptos que se presentan en la guía de protocolo 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 actividades 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 el siguiente:
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName es "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 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 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 "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, 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 datos de sitios permite los siguientes parámetros opcionales para enviar una solicitud GET con el feed de contenido:
| Parámetro | Descripción | Tipo | Notas |
|---|---|---|---|
ancestor |
Solicita solo las entradas que tienen el ancestro especificado. | string | Proporciona el ID de la entrada ancestral deseada. Por ejemplo: 0123456789. Muestra todas las entradas que tienen el ancestro especificado como superior, el superior de un 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 entradas preliminares. | booleano | 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 los tipos de entradas de contenido que se mostrarán. Estas siguen el tipo de página en 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 las entradas que tienen el elemento superior especificado. | string | Proporciona el ID de la entrada superior. Por ejemplo: 0123456789. |
path |
Solicita contenido en una jerarquía de páginas determinada | string | 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 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 el siguiente:
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName es "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 deben autenticarse.
Tipos de solicitud admitidos: GET
Feed del sitio
El feed de sitios se puede usar para mostrar los sitios de Google Sites que un usuario posee 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 uno existente.
El URI del feed de 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 deben autenticarse.
Tipos de solicitud admitidos: GET, POST y PUT
El feed del sitio admite los siguientes parámetros (opcionales) cuando se envía una solicitud GET para crear fichas de sitios:
| Parámetro | Descripción | Tipo | Notas |
|---|---|---|---|
include-all-sites |
Muestra una lista de 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 de 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 de la ficha 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 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 datos de Google:
max-resultspublished-max(solo feed de contenido)published-min(solo feed de contenido)start-indexupdated-maxupdated-minq(consultas de texto completo)
Consulta la sección anterior cada feed para obtener una lista de los parámetros específicos de ese feed.