En este documento, se proporciona 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 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 para desarrolladores.
Público
Este documento está dirigido a los programadores que desean crear aplicaciones cliente que puedan interactuar con Google Sites.
Es un documento de referencia. se da por sentado que comprendes los conceptos que se presentan en la guía del 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 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 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/.
Se deben autenticar todas las solicitudes a este feed.
Tipos de solicitud admitidos: GET
Canal de contenido
El feed 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 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 o no requerir autenticación, según la configuración del sitio (publicado).
Tipos de solicitud admitidos: GET, POST, PUT y DELETE
Además de los parámetros de consulta estándar de la API de datos, la API de Sites Data permite los siguientes parámetros opcionales:
Emite una solicitud de GET mediante el feed 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, el superior del superior, y así sucesivamente. |
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 preliminares. | 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 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,
template |
parent |
Solo solicita entradas que tengan el 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 | 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 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 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.
Se deben autenticar todas las solicitudes a este feed.
Tipos de solicitud admitidos: GET
Feed del sitio
El feed del sitio se puede usar para crear una lista de los sitios de Google que un usuario posee o para los que tiene permisos de lectura. También se puede usarse 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.
Se deben autenticar todas las solicitudes a este feed.
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 |
Enumere todos los sitios que, al menos, los usuarios pueden ver en el dominio de G Suite. | boolean | Este parámetro solo es aplicable 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. | 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 Sites.
El URI del feed de 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.
Se deben autenticar todas las solicitudes a este feed.
Tipos de solicitud admitidos: GET, POST, PUT y DELETE
Referencia de los parámetros de consulta de Google Sites
Parámetros de consulta admitidos por 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)
Consulta la sección anterior cada feed para obtener una lista de los parámetros específicos de ese feed.