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.