В этом документе содержится подробная справочная документация по необработанному протоколу (XML и HTTP) для API данных Blogger.
Этот документ не содержит информации о клиентских библиотеках языков программирования. Справочную информацию по клиентской библиотеке см. по ссылкам в разделах, посвященных конкретным языкам программирования, в руководстве разработчика.
Содержание
Аудитория
Этот документ предназначен для программистов, которые хотят писать клиентские приложения, взаимодействующие с Blogger.
Это справочный документ; предполагается, что вы понимаете концепции, представленные в руководстве разработчика , и общие идеи, лежащие в основе протокола API данных Google .
Типы каналов Blogger
Blogger предоставляет два вида представления контента блога в фидах: полные фиды и сводные фиды. Полная лента содержит полные сообщения блога, а сводная лента содержит только короткий фрагмент каждого сообщения.
Владелец блога может указать с помощью настроек графического интерфейса, предоставляет ли блог полную ленту или сводную ленту для синдикаторов и агрегаторов.
Когда ваше клиентское приложение отправляет неаутентифицированный запрос фида, оно получает тот тип фида, который указал владелец блога.
Однако когда ваше клиентское приложение отправляет аутентифицированный запрос, оно всегда получает полную ленту, независимо от того, что указал владелец блога.
Справочник по параметрам запроса Blogger
API данных Blogger поддерживает почти все стандартные параметры запроса API данных Google .
Blogger не поддерживает параметр author .
Параметры запроса updated-min и updated-max игнорируются, если для параметра orderby не задано значение updated . Например, следующий URL-адрес извлекает все сообщения блога, которые были обновлены с 16 марта 2008 г. по 24 марта 2008 г.:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Справочник по элементам Blogger
API данных Blogger использует только стандартные элементы Atom; для получения дополнительной информации см. спецификацию формата синдикации Atom 1.0 и протокол публикации Atom .
В оставшейся части этого раздела содержится пара конкретных замечаний об использовании в Blogger некоторых стандартных элементов.
Черновики записей
Черновая запись блога помечается с помощью элемента расширения <app:draft> , определенного в документе Atom Publishing Protocol. Вот пример черновой записи:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Если элемент <draft> не указан, запись не является черновиком.
Даты публикации и обновленные даты
Отметка времени, указанная в стандартном элементе Atom <published> , соответствует «дате публикации», которую пользователь может установить в графическом интерфейсе Blogger.
Когда ваш клиент создает новую запись, если клиент не указывает значение для <published> , Blogger устанавливает дату публикации записи в соответствии с текущим серверным временем. Когда ваш клиент редактирует запись, но не указывает значение <published> , Blogger не трогает дату публикации записи.
Однако если ваш клиент указывает значение для элемента <published> при создании или редактировании записи, Blogger устанавливает дату публикации записи в указанное значение. Это может быть полезно для таких задач, как импорт старых записей из другой системы ведения блога (с сохранением исходных дат создания).
Blogger использует стандартный элемент Atom <updated> , чтобы указать, когда запись была изменена в последний раз. Ваш клиент не может контролировать значение <updated> ; Blogger всегда устанавливает дату последнего обновления записи на текущее время сервера всякий раз, когда ваш клиент публикует или редактирует запись.
Вы можете использовать стандартные параметры запроса Google Data API published-min , published-max , updated-min и updated-max для запроса записей на основе их значений <published> или <updated> . Однако примечания о запросах по обновленным датам см. в разделе Справочник по параметрам запросов Blogger .
Связывание комментариев с сообщениями
Формат экспорта Blogger содержит записи и комментарии в одном документе канала Atom. Чтобы различать два типа записей, Blogger использует элемент <atom:category> . Этот элемент будет иметь параметр term , который отражает, предназначена ли запись для публикации или комментария.
Кроме того, связывание записи комментария с записью сообщения, к которой она принадлежит, осуществляется с помощью расширения Atom Threading Extension . В приведенном ниже примере элемент <thr:in-reply-to> в записи комментария будет указывать на запись с помощью идентификатора записи записи в параметре ref . Он также ссылается на URL-адрес HTML сообщения через параметр href .
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
xmlns:thr="http://purl.org/syndication/thread/1.0">
...
<-- A blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID</id>
<content type="html">This is my first post</content>
<link rel="alternate" type="text/html"
href="http://blogName.blogspot.com/2007/04/first-post.html">
</link>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#post"/>
...
</entry>
<-- A comment to the blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
<content type="html">This is my first commment</content>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#comment"/>
<thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html"
ref="tag:blogger.com,1999:blog-blogID.post-postID"
type="text/html"/>
...
</entry>
</feed>