Руководство разработчика: Протокол

Важно : это старая версия этой страницы. Для получения последней версии используйте ссылки на левой панели навигации.

API данных Blogger позволяет клиентским приложениям просматривать и обновлять контент Blogger в виде каналов API данных Google.

Ваше клиентское приложение может использовать API данных Blogger для создания новых сообщений в блоге, редактирования или удаления существующих сообщений в блоге, а также для запроса сообщений в блоге, соответствующих определенным критериям.

Помимо общей информации о возможностях API данных Blogger, в этом документе приводятся примеры базового взаимодействия API данных с использованием необработанного XML и HTTP. Прочитав этот документ, вы, возможно, захотите узнать больше о взаимодействии с API с использованием наших клиентских библиотек , прочитав разделы этого руководства для разработчиков, посвященные конкретным языкам программирования.

Содержание

  1. Аудитория
  2. Начиная
    1. Создание учетной записи Blogger
  3. Аутентификация в сервисе Blogger
    1. Аутентификация прокси-сервера AuthSub
    2. Аутентификация по имени пользователя и паролю ClientLogin
  4. Получение списка блогов
  5. Создание постов
    1. Публикация сообщения в блоге
    2. Создание черновика записи в блоге
  6. Получение сообщений
    1. Получение всех сообщений блога
    2. Получение сообщений с использованием параметров запроса
  7. Обновление сообщений
  8. Удаление сообщений
  9. Комментарии
    1. Создание комментариев
    2. Получение комментариев
    3. Удаление комментариев
  10. Формат экспорта

Аудитория

Этот документ предназначен для программистов, желающих писать клиентские приложения, способные взаимодействовать с Blogger с помощью XML и HTTP.

В этом документе предполагается, что вы понимаете общие идеи протокола API данных Google .

Если вы используете систему UNIX и хотите опробовать примеры из этого документа без написания кода, вам могут пригодиться утилиты командной строки UNIX curl или wget ; дополнительную информацию см. в руководствах по этим утилитам.

Справочную информацию об API данных Blogger см. в справочном руководстве по протоколу .

Начиная

Создание учетной записи Blogger

Возможно, вы захотите зарегистрировать учетную запись Blogger в целях тестирования. Blogger использует учетные записи Google , поэтому, если у вас уже есть учетная запись Google, все готово.

Аутентификация в сервисе Blogger

Вы можете получить доступ как к общедоступным, так и к частным каналам с помощью API данных Blogger. Публичные каналы не требуют аутентификации, но доступны только для чтения. Если вы хотите изменить блоги, вашему клиенту необходимо пройти аутентификацию перед запросом частных каналов. Он может аутентифицироваться, используя любой из двух подходов: аутентификацию прокси-сервера AuthSub или аутентификацию имени пользователя и пароля ClientLogin .

Дополнительную информацию об аутентификации с помощью API данных Google в целом см. в документации по аутентификации .

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

Аутентификация прокси-сервера AuthSub

Аутентификация прокси-сервера AuthSub используется веб-приложениями, которым необходимо аутентифицировать своих пользователей в учетных записях Google. Оператор веб-сайта и клиентский код не имеют доступа к имени пользователя и паролю пользователя Blogger; вместо этого клиент получает специальные токены AuthSub, которые позволяют клиенту действовать от имени конкретного пользователя. Более подробную информацию смотрите в документации AuthSub .

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

Следующие параметры запроса включены в URL-адрес AuthSubRequest:

следующий
URL-адрес страницы, на которую Google должен перенаправить пользователя после аутентификации.
объем
Указывает, что приложение запрашивает токен для доступа к каналам Blogger. Используемая строка области действия — http://www.blogger.com/feeds/ (разумеется, в URL-кодировке).
безопасный
Указывает, запрашивает ли клиент безопасный токен.
сессия
Указывает, можно ли обменять возвращенный токен на многоразовый (сессионный) токен.

URL-адрес AuthSubRequest может выглядеть следующим образом:

https://www.google.com/accounts/AuthSubRequest?scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F&session=1&secure=0&next=http%3A%2F%2Fwww.example.com%2Fwelcome.html

Пользователь переходит по ссылке на сайт Google и авторизуется в своей учетной записи Google.

После аутентификации пользователя система AuthSub перенаправляет его на URL-адрес, указанный в next параметре запроса URL-адреса AuthSubRequest. Система AuthSub добавляет токен аутентификации к этому URL-адресу в качестве значения параметра запроса token . Например:

http://www.example.com/welcome.html?token=yourAuthToken

Это значение токена представляет собой одноразовый токен AuthSub. В этом примере, поскольку был указан session=1 , этот токен можно обменять на токен сеанса AuthSub, вызвав службу AuthSubSessionToken с одноразовым токеном в заголовке авторизации, как показано ниже:

GET /accounts/AuthSubSessionToken HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: AuthSub token="yourAuthToken"
User-Agent: Java/1.5.0_06
Host: www.google.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive

Ответ службы AuthSubSessionToken включает заголовок Token , содержащий токен сеанса, и заголовок Expiration , указывающий, как долго токен будет оставаться действительным.

Затем ваше приложение сможет использовать значение токена сеанса в заголовке Authorization при последующих взаимодействиях с Blogger.

Вот пример HTTP-запроса, содержащего незащищенный токен, который вы можете отправить в Blogger:

GET /feeds/blogID/blogs/posts/defaults HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: AuthSub token="yourSessionToken"
User-Agent: Java/1.5.0_06
Host: www.blogger.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive

Аутентификация по имени пользователя и паролю ClientLogin

Используйте аутентификацию ClientLogin, если ваш клиент является автономным, однопользовательским «установленным» клиентом (например, настольным приложением). Чтобы запросить токен аутентификации с помощью механизма ClientLogin, отправьте запрос POST по следующему URL-адресу:

https://www.google.com/accounts/ClientLogin

Тело POST должно содержать набор параметров запроса, которые выглядят как параметры, передаваемые формой HTML, с использованием типа контента application/x-www-form-urlencoded . Эти параметры:

Электронная почта
Адрес электронной почты пользователя.
пароль
Пароль пользователя.
услуга
Имя службы Blogger — blogger . (Другие имена служб см. в списке имен служб .)
тип аккаунта
При использовании API Blogger всегда следует устанавливать значение GOOGLE . Если этот параметр не задан, доступ к нему будет закрыт для пользователей, у которых также есть учетная запись G Suite .
источник
Идентифицирует ваше клиентское приложение. Должен иметь форму companyName — applicationName — versionID . В примерах используется имя exampleCo-exampleApp-1 .

Дополнительную информацию о параметрах см. в документе «Аутентификация для установленных приложений» .

Если запрос аутентификации завершается неудачей, сервер возвращает код состояния HTTP 403 Forbidden .

Если это удалось, сервер возвращает код состояния HTTP 200 OK , а также три длинных буквенно-цифровых кода в теле ответа: SID, LSID и Auth. Значение Auth — это токен авторизации, который вы будете отправлять в Blogger с каждым последующим запросом, поэтому сохраните копию этого значения. Вы можете игнорировать значения SID и LSID.

Поскольку все запросы к частным каналам требуют аутентификации, вам необходимо установить заголовок авторизации во всех последующих взаимодействиях с Blogger, используя следующий формат:

Authorization: GoogleLogin auth=yourAuthToken

Где yourAuthToken — это строка аутентификации, возвращаемая запросом ClientLogin.

Дополнительные сведения об аутентификации ClientLogin, включая примеры запросов и ответов, см. в документации по аутентификации для установленных приложений .

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

Примечание . Как описано в документации ClientLogin, запрос аутентификации может завершиться неудачей и запросить проверку CAPTCHA. Если вы хотите, чтобы Google выполнил и обработал запрос CAPTCHA, отправьте пользователя на https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger (а не на URL-адрес обработки CAPTCHA, указанный в документации ClientLogin).

Получение списка блогов

API данных Blogger предоставляет канал, в котором перечислены блоги конкретного пользователя; этот канал известен как «метафид».

Отправьте HTTP GET по следующему URL-адресу, чтобы получить список блогов:

http://www.blogger.com/feeds/userID/blogs

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

Запись в метафиде может выглядеть так:

<entry>
  <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
  <published>2006-08-02T18:44:43.089-07:00</published>
  <updated>2006-11-08T18:10:23.020-08:00</updated>
  <title type='text'>Lizzy's Diary</title>
  <summary type='html'>Being the journal of Elizabeth Bennet</summary>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/'>
  </link>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/userID/blogs/blogID'>
  </link>
  <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/userID/blogs/blogID'>
  </link>
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
</entry>

Информацию о том, что означает каждый из этих элементов, см. в справочном документе по протоколу API данных Google или в спецификации Atom 1.0 .

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

Создание постов

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

Публикация сообщения в блоге

После аутентификации вы можете публиковать новые записи в блоге.

Сначала создайте XML-представление публикации для публикации. Этот XML должен быть в форме элемента Atom <entry> , который может выглядеть следующим образом:

<entry xmlns='http://www.w3.org/2005/Atom'>
  <title type='text'>Marriage!</title>
  <content type='xhtml'>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p>Mr. Darcy has <em>proposed marriage</em> to me!</p>
      <p>He is the last man on earth I would ever desire to marry.</p>
      <p>Whatever shall I do?</p>
    </div>
  </content>
  <category scheme="http://www.blogger.com/atom/ns#" term="marriage" />
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" />
</entry>

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

Чтобы опубликовать эту запись, отправьте ее на URL-адрес публикации блога следующим образом. Сначала поместите элемент Atom <entry> в тело нового запроса POST , используя тип контента application/atom+xml . Затем найдите URL-адрес публикации блога в метафиде, найдя элемент <link> , где атрибут rel заканчивается #post . URL-адрес публикации блога задается как атрибут href этого элемента, который имеет следующий формат:

http://www.blogger.com/feeds/blogID/posts/default

Примечание . Этот URL-адрес совпадает с URL-адресом в теге <link rel="service.post"> , который отображается в разделе <head> удобочитаемой версии блога.

Blogger создает сообщение в блоге, используя отправленную вами запись, а затем возвращает код состояния HTTP 201 CREATED вместе с копией нового сообщения в виде элемента <entry> . Возвращенная запись аналогична отправленной вами, но она также содержит различные элементы, добавленные Blogger, например элемент <id> .

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

Создание черновика публикации в блоге

Черновики сообщений создаются так же, как и общедоступные сообщения, но к записи добавляется элемент <app:control> , указывающий, что сообщение (пока) не должно быть опубликовано.

Этот элемент <app:control> должен содержать один дочерний элемент <app:draft> :

<app:control xmlns:app='http://purl.org/atom/app#'>
  <app:draft>yes</app:draft>
</app:control>

Данные, содержащиеся в элементе <app:draft> должны быть строкой yes , чтобы сообщение было распознано как черновик.

Вы можете превратить существующий черновик сообщения в блоге в опубликованное сообщение, получив черновик сообщения, установив для данных элемента <app:draft> строку no , а затем обновив сообщение. Получение и обновление сообщений описано в следующих двух разделах.

Примечание . Дополнительную информацию о протоколе публикации Atom, включая пространства имен <app:control> и <app:draft> , см. в RFC 5023 .

Получение сообщений

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

Вы можете запросить общедоступный канал Blogger без аутентификации. Таким образом, вам не нужно задавать параметр авторизации при получении сообщений из общедоступного блога.

Получение всех сообщений блога

Чтобы получить сообщения пользователя, отправьте HTTP-запрос GET на URL-адрес канала блога. Затем Blogger возвращает канал, содержащий соответствующие записи блога. Например, чтобы получить список сообщений блога для liz@gmail.com, отправьте в Blogger следующий HTTP-запрос (разумеется, с соответствующим значением вместо blogID ):

GET http://www.blogger.com/feeds/blogID/posts/default

Затем Blogger возвращает код состояния HTTP 200 OK и стандартный канал Atom 1.0, содержащий сообщения блога.

Ниже приведен пример канала для блога, содержащего только одну публикацию. Обратите внимание, что мы немного отредактировали этот пример, чтобы сделать его более читабельным для людей. В частности, настоящий канал Blogger содержит реальные идентификаторы и URL-адреса.

<feed xmlns='http://www.w3.org/2005/Atom'>
  <id>tag:blogger.com,1999:blog-blogID</id>
  <updated>2006-11-08T18:10:23.020-08:00</updated>
  <title type='text'>Lizzy's Diary</title>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/index.html'>
  </link>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
  <generator version='7.00' uri='http://www2.blogger.com'>Blogger</generator>
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <published>2006-11-08T18:10:00.000-08:00</published>
    <updated>2006-11-08T18:10:14.954-08:00</updated>
    <title type='text'>Quite disagreeable</title>
    <content type='html'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
      this evening. I found him quite disagreeable.&lt;/p&gt;</content>
    <link rel='alternate' type='text/html'
      href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'>
    </link>
    <link rel='self' type='application/atom+xml'
      href='http://blogName.blogspot.com/feeds/posts/default/postID'>
    </link>
    <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/posts/default/postID'>
    </link>
    <author>
      <name>Elizabeth Bennet</name>
      <email>noreply@blogger.com</email>
      <uri>http://www.blogger.com/profile/profileID</uri>
    </author>
  </entry>
</feed>

Получение сообщений с использованием параметров запроса

API данных Blogger позволяет запрашивать набор записей, соответствующих заданным критериям, например запрос публикаций в блоге или обновлений в заданном диапазоне дат.

Например, чтобы отправить запрос диапазона дат, добавьте параметры published-min и published-max в URL-адрес запроса. Чтобы получить все записи блога, созданные в период с 16 марта 2008 г. по 24 марта 2008 г., отправьте HTTP-запрос на URL-адрес канала блога:

GET http://www.blogger.com/feeds/blogID/posts/default?published-min=2008-03-16T00:00:00&published-max=2008-03-24T23:59:59

Когда вы отправляете этот запрос GET , Blogger возвращает код состояния HTTP 200 OK и фид, содержащий все сообщения блога, созданные в указанном вами диапазоне дат.

Параметры updated-min и updated-max также можно использовать для обновления всех записей блога в заданном диапазоне. Однако обратите внимание, что эти параметры игнорируются, если для параметра orderby также не установлено значение updated .

API данных Blogger поддерживает следующие параметры запроса:

альтернативный вариант
Тип возвращаемого канала, например atom (по умолчанию) или rss .
/category
Указывает категории (также известные как метки) для фильтрации результатов ленты. Например, http://www.blogger.com/feeds/ blogID /posts/default/-/Fritz/Laurie возвращает записи с метками Fritz и Laurie .
максимальные результаты
Максимальное количество возвращаемых записей.
Сортировать по
Порядок возврата записей, например lastmodified (по умолчанию), starttime или updated .
опубликованный минимум, опубликованный максимум
Границы дат публикации записей.
стартовый индекс
Индекс первого результата, отсчитываемого от 1 (для разбиения по страницам).
обновленный минимум, обновленный максимум
Границы дат обновления записей. Эти параметры запроса игнорируются, если для параметра orderby не установлено значение updated .

Дополнительную информацию о параметрах запроса см. в Справочном руководстве по API данных Blogger и Справочном руководстве по API данных Google .

Обновление сообщений

Чтобы обновить существующую запись в блоге, сначала вы получаете запись, которую хотите обновить, затем изменяете ее, а затем отправляете запрос PUT с обновленной записью в теле сообщения на URL-адрес редактирования записи. Убедитесь, что значение <id> в записи, которую вы PUT точно соответствует <id> существующей записи.

URL-адрес редактирования выделен в следующей записи:

<entry>
  <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
  <published>2006-11-08T18:10:00.000-08:00</published>
  <updated>2006-11-08T18:10:14.954-08:00</updated>
  <title type='text'>Quite disagreeable</title>
  <content type='html'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
    this evening. I found him quite disagreeable.&lt;/p&gt;</content>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default/postID'>
  </link>
  <link rel='edit' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default/postID'>
  </link>
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Bingley" />
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" />
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
</entry>

ВАЖНО . Чтобы обеспечить совместимость, убедитесь, что при PUT обновленной записи сохраняется весь XML-код, который присутствовал при получении записи из Blogger. В противном случае, когда мы реализуем новые возможности и включаем элементы <new-awesome-feature> в фид, ваш клиент не вернет их, и ваши пользователи упустят их. Все клиентские библиотеки API данных Google обрабатывают это правильно, поэтому, если вы используете одну из библиотек, все готово.

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

Совет по устранению неполадок . Некоторые брандмауэры блокируют сообщения HTTP PUT . Чтобы обойти эту проблему, вы можете включить заголовок X-HTTP-Method-Override: PUT в запрос POST . Подробную информацию см. в документе по основам протокола API данных Google .

Удаление сообщений

Чтобы удалить сообщение, отправьте запрос DELETE на URL редактирования сообщения. Это тот же URL-адрес, который используется для обновления сообщений .

Совет по устранению неполадок . Некоторые брандмауэры блокируют сообщения HTTP DELETE . Чтобы обойти эту проблему, вы можете включить заголовок X-HTTP-Method-Override: DELETE в запрос POST . Подробную информацию см. в документе по основам протокола API данных Google .

Комментарии

API данных Blogger позволяет создавать, получать и удалять комментарии. Обновление комментариев не поддерживается (и недоступно в веб-интерфейсе).

Создание комментариев

Чтобы опубликовать комментарий, создайте элемент Atom <entry> , как показано ниже:

  <entry xmlns='http://www.w3.org/2005/Atom'>
    <title type="text">This is my first comment</title>
    <content type="html">This is my first comment</content>
  </entry>

Чтобы опубликовать этот комментарий, поместите элемент Atom <entry> в тело нового запроса POST , используя тип контента application/atom+xml . Затем отправьте запрос POST на соответствующий URL-адрес Blogger:

POST http://www.blogger.com/feeds/blogID/postID/comments/default

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

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

Получение комментариев

Вы можете получить комментарии к определенному сообщению, отправив GET на URL-адрес канала комментариев этого сообщения:

GET http://www.blogger.com/feeds/blogID/postID/comments/default

Или вы можете получить комментарии ко всем публикациям, используя URL-адрес ленты комментариев блога:

GET http://www.blogger.com/feeds/blogID/comments/default

Эти запросы возвращают ленту комментариев, которая выглядит следующим образом:

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
         xmlns:thr="http://purl.org/syndication/thread/1.0">
  <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
  <updated>2007-04-04T21:56:29.803-07:00</updated>
  <title type="text">My Blog : Time to relax</title>
  <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html"/>
  <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/>
  <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/>
  <author>
    <name>Blog Author name</name>
  </author>
  <generator version="7.00" uri="http://www2.blogger.com">Blogger</generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-commentID</id>
    <published>2007-04-04T21:56:00.000-07:00</published>
    <updated>2007-04-04T21:56:29.803-07:00</updated>
    <title type="text">This is my first comment</title>
    <content type="html">This is my first comment</content>
    <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html#commentID"/>
    <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default/commentID"/>
    <link rel="edit" type="application/atom+xml" href="http://www.blogger.com/feeds/blogID/postID/comments/default/commentID"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     source="http://www.blogger.com/feeds/posts/default/blogID"
                     type="text/html"/>
    <author>
      <name>Blog Author name</name>
      <email>blog_author@gmail.com</email>
      <uri>http://www.blogger.com/profile/userID</uri>
    </author>
    <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0' 
         href='http://blogName.blogspot.com/2007/04/first-post.html' 
         ref='tag:blogger.com,1999:blog-blogID.post-postID' 
         source='http://blogName.blogspot.com/feeds/posts/default/postID'
         type='text/html' />
  </entry>
</feed>

Удаление комментариев

Чтобы удалить комментарий, отправьте запрос DELETE на URL-адрес редактирования комментария. Этот URL-адрес выделен в ленте комментариев выше.

Формат экспорта

Blogger позволяет пользователям экспортировать и импортировать свои блоги с помощью файла экспорта Blogger. Этот файл экспорта содержит все публикации и комментарии одного блога. Формат файла экспорта — это тот же формат Atom, который описан в разделах, посвященных получению сообщений и комментариев. Этот файл экспорта будет содержать содержимое ленты сообщений и содержимое ленты комментариев, объединенных в один документ.

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

GET http://www.blogger.com/feeds/blogID/archive

Чтобы импортировать файл экспорта, создайте запрос POST по следующему URL-адресу с содержимым файла экспорта в качестве данных запроса и application/atom+xml в качестве типа контента:

POST http://www.blogger.com/feeds/blogID/archive/full

Ни один из приведенных выше URL-адресов не поддерживает параметры запроса. Оба запроса также должны содержать информацию для аутентификации , и только администраторы блога смогут импортировать/экспортировать блог, используя эти URL-адреса каналов.

Примечание . Если вы создаете собственный файл экспорта Blogger, в настоящее время существует одно ограничение на порядок записей записей и комментариев. В файле экспорта Blogger сначала будут перечислены все публикации, а затем все комментарии. Чередование записей сообщений и комментариев разрешено при условии, что запись комментария идет после сообщения, к которому он предназначен.

Дополнительные сведения о том, как Blogger использует формат Atom в файле экспорта, см. в справочном руководстве по протоколу .

Вернуться наверх