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

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

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

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

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

Содержание

  1. Аудитория
  2. Начиная
    1. Создание учетной записи блогера
  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 использует учетные записи Google , поэтому, если у вас уже есть учетная запись Google, все готово.

Аутентификация в службе Blogger

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

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

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

Аутентификация прокси-сервера 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 должен быть в форме элемента <entry> Atom, который может выглядеть следующим образом:

<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-адресу сообщения в блоге следующим образом. Сначала поместите элемент <entry> Atom в тело нового запроса 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 без аутентификации. Таким образом, вам не нужно задавать параметр Authorization при получении сообщений из общедоступного блога.

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

Чтобы получить сообщения пользователя, отправьте 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 позволяет запрашивать набор записей, соответствующих заданным критериям, например, запрашивать сообщения в блоге, опубликованные или обновленные в указанном диапазоне дат.

Например, чтобы отправить запрос диапазона дат, добавьте в URL-адрес запроса параметры publish published-min и published-max . Чтобы получить все записи блога, созданные в период с 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> в ленту, ваш клиент не вернет их, а ваши пользователи пропустят. Все клиентские библиотеки Google Data API обрабатывают это правильно, поэтому, если вы используете одну из библиотек, все готово.

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

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

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

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

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

Комментарии

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

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

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

  <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>

Чтобы опубликовать этот комментарий, поместите элемент <entry> Atom в тело нового запроса 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, который описан в разделах, посвященных получению сообщений и комментариев. Этот экспортный файл будет содержать содержимое ленты сообщений и содержимое ленты комментариев, объединенных в один документ.

Чтобы экспортировать или импортировать данные блога с использованием формата экспорта, вы можете посетить страницу настроек блога. Чтобы получить файл экспорта для блога с помощью Data 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 в файле экспорта, см. в справочном руководстве по протоколу .

Вернуться к вершине