Обзор API Google Wave

Добро пожаловать в разработку волн

API Google Wave представляет собой открытую платформу, которая позволяет разработчикам развивать сам Google Wave, а также расширять функциональные возможности других приложений с помощью волн. Разработчики могут рассматривать Google Wave как совокупность трех составляющих:

• клиентское приложение Google Wave, интерфейс для пользователей;
• API Google Wave, описанные на этом сайте;
• федеративный протокол Google Wave, базовый сетевой протокол для взаимодействия волн.

В этом руководстве разработчика описаны API Wave и их использование для развития Google Wave посредством расширений, а также для обеспечения дополнительной функциональности сторонних веб-приложений благодаря встраиванию в них Google Wave. В этом обзоре описаны составляющие волн в модели Google Wave.

Объекты волн

Для эффективного программирования с использованием API Google Wave требуется базовое понимание концепции волн.

Волна представляет собой потоковое обсуждение, осуществляемое одним или несколькими участниками (участниками могут быть как люди, так и роботы). Волна является динамическим объектом, который обладает состоянием и хранит историю. Она постоянно изменяется в режиме реального времени за счет общения участников. Волна служит контейнером для одного или нескольких вейвлетов, описание которых приводится ниже.

Вейвлет представляет собой потоковое обсуждение, созданное из волны (включая исходное обсуждение). Вейвлеты служат контейнерами для одного или нескольких сообщений, известных как всплески. Вейвлет является основным элементом для управлением доступом к данным в волне. Все участники вейвлета обладают полным доступом ко всему содержанию вейвлета с возможностью чтения и записи. Таким образом, все события, возникающие в API Google Wave, происходят на уровне вейвлетов или на более низких уровнях.

При создании вейвлета из волны разрешения на доступ из родительского вейвлета не наследуются. Во время срока жизни волны можно вести конфиденциальные обсуждения. Они становятся отдельными вейвлетами, но объединяются в одной и той же волне. Поскольку события происходят не выше уровня вейвлетов, контекст события ограничен одним вейвлетом. Можно создать вейвлет и управлять им с помощью робота, являющегося его единственным участником. Благодаря этому робот может эффективно использовать вейвлет в качестве документа с конфиденциальными данными. Данные этих документов могут быть как структурированными, так и не структурированными данными о вейвлете. Они никогда не отображаются и не раскрываются пользователю.

Всплеск является базовым элементом обсуждения и состоит из отдельных сообщений, отображаемых в вейвлете. Всплески могут быть представлены в виде черновиков или быть опубликованы (путем нажатия кнопки "Готово" в клиенте Google Wave). Всплески управляют своим содержанием с помощью документов, описание которых приведено ниже. Кроме того, всплески могут содержать другие всплески в качестве потомков. Таким образом формируется иерархия всплесков. Каждый вейвлет содержит по крайней мере один корневой всплеск.

Документ представляет собой содержание, прикрепленное к всплеску. Этот документ содержит XML-код, который можно получить, изменить и добавить с помощью API. Как правило, структура данных XML не изменяется напрямую. Вместо этого управление документом осуществляется с помощью удобных методов.

Что такое API Google Wave?

На самом деле API Google Wave состоит из нескольких API с разными функциональными возможностями (которые можно объединить). В API Google Wave предусмотрены два основных способа разработки:

• Расширения

  Разработчики могут внести свой клад в развитие Google Wave, создавая небольшие приложения (расширения), взаимодействующие с Google Wave. Они могут создавать роботов, взаимодействующих с волнами, или гаджеты, с которыми могут взаимодействовать участники, а также различные комбинации роботов и гаджетов. Дополнительную информацию можно получить в Руководстве разработчика по расширениям Google Wave.

• Встроенные волны

  Разработчики могут расширять функциональность своих веб-приложений, встраивая в них Google Wave, что позволяет органично интегрировать в них возможности общения и совместной работы. Дополнительную информацию можно получить в Руководстве разработчика по встраиванию волн.

Помимо руководства разработчика и других справочных материалов, можно ознакомиться с примерами кода.

К началу