Важно ! Мы прекратим поддержку API данных Google v2.0 30 сентября 2024 г. Чтобы обеспечить бесперебойную работу, обновите свои приложения, использующие API данных Google v2.0, до последней версии API. Для получения последней версии используйте ссылки на левой панели навигации. Примечание. Хотя некоторые запросы GET (например, публикации в списках) будут по-прежнему поддерживаться как URL-адреса каналов, в их поведении есть небольшие различия. Подробную информацию можно найти в справочной документации Blogger .
В этом документе представлена подробная справочная документация по необработанному протоколу (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. Вот пример черновика записи:
<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 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 . Он также ссылается на 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 comment</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>