Mis favoritos | Español | Acceder

Aspectos generales del API de Google Wave

¡Te damos la bienvenida al desarrollo de Wave!

El API de Google Wave es una plataforma abierta que permite a los desarrolladores ampliar las funciones de Google Wave en sí mismas o ampliar otras aplicaciones con olas. Como desarrollador, puedes pensar en Google Wave como tres fragmentos:

  • la aplicación cliente de Google Wave, la interfaz diseñada por los usuarios,
  • las API de Google Wave, que se mencionan en este sitio,
  • el protocolo de federación de Google Wave (Google Wave Federation Protocol), el protocolo de red subyacente para la comunicación de olas.

Esta guía de desarrolladores trata las API de Wave y cómo puedes utilizarlas para ampliar Google Wave a través de extensiones o para ampliar las aplicaciones web de terceros mediante la inserción de Google Wave. En estos aspectos generales se tratan los elementos que componen las "olas" en el modelo de Google Wave.

Entidades de Wave

La programación efectiva mediante las API de Google Wave requiere la comprensión de algunos conceptos básicos de las olas.

Una ola es una conversación encadenada, que consta de uno o varios participantes (que puede incluir participantes humanos y robots). La ola es una entidad dinámica que contiene el estado y almacena información de historial. Una ola es un elemento activo, con participantes que se comunican y modifican la ola en tiempo real. Una ola se utiliza como contenedor para una o varias óndulas que se definen más abajo.

Una óndula es una conversación encadenada que se genera en una ola (incluida la conversación inicial). Las óndulas se utilizan como contenedor para uno o varios mensajes, que se conocen como señalizaciones visuales. La óndula es la unidad básica de control de acceso para los datos de la ola. Todos los participantes de una óndula disponen de un acceso completo de lectura y escritura a todo el contenido de la misma. Asimismo, todos los eventos que se producen en las API de Google Wave funcionan en el nivel de la óndula o inferior.

Cuando generas una óndula desde una ola, no heredas ningún permiso de acceso de la óndula principal. Durante la vida útil de una ola, puedes generar conversaciones privadas, que se convierten en óndulas independientes, pero se agrupan en la misma "ola". Puesto que los eventos se producen en el nivel de la óndula o en un nivel inferior, el contexto de un evento se limita a una única óndula. Una óndula se puede crear y gestionar con un robot como su único participante. Esto permite al robot utilizar la óndula de forma efectiva como un documento de datos privados. Estos documentos de datos no se muestran nunca al usuario y pueden contener datos sobre la óndula estructurados o sin estructurar.

Una señalización visual es la unidad básica de conversación y consta de mensajes únicos que aparecen en una óndula. Las señalizaciones visuales pueden ser borradores o publicadas (haciendo clic en "Done" en el cliente de Wave). Las señalizaciones visuales gestionan su contenido a través de su documentación, que se define más abajo. Las señalizaciones visuales también pueden contener otras señalizaciones visuales como secundarias, formando así una jerarquía de señalizaciones. Todas las óndulas constan siempre de al menos una señalización visual raíz.

 

Un documento es el contenido que se adjunta a una señalización visual. Este documento consta de XML que el API puede recuperar, modificar o añadir. Por lo general, gestionas el documento a través de cómodos métodos en lugar de a través de la manipulación directa de la estructura de datos XML.

¿Qué es el API de Google Wave?

El "API de Wave" consta en realidad de varias API que proporcionan diferentes funciones (y que se pueden combinar entre sí). Existen dos tipos de desarrollo principales disponibles en el API de Wave:

  • Extensiones:

    Los desarrolladores pueden mejorar Google Wave mediante la autorización de miniaplicaciones (extensiones) que interactúan con Wave. Los desarrolladores pueden crear robots que interactúan con olas o gadgets con los que pueden interactuar los participantes (también se admiten las combinaciones de robots y gadgets). Para obtener más información, consulta la Guía de desarrolladores de extensiones de Wave.

  • Olas insertadas:

    Los desarrolladores pueden mejorar sus aplicaciones web existentes insertando Google Wave directamente en la aplicación, lo que permite integrar sin problemas comunicación y colaboración. Para obtener más información, consulta la Guía de desarrolladores de inserción de Wave.

Además de la guía de desarrolladores y del material de referencia, puede que desees consultar el código de ejemplo.

Volver al principio