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

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

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

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

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

Содержание

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

Аудитория

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

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

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

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

Начиная

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

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

Авторизация запросов

Когда ваше приложение запрашивает закрытые данные пользователя, оно должно включать токен авторизации. Токен также идентифицирует ваше приложение для Google.

О протоколах авторизации

Мы рекомендуем использовать OAuth 2.0 для авторизации запросов.

API GData Blogger также поддерживает более старые варианты авторизации, такие как OAuth 1.0 , AuthSub или ClientLogin ; однако в большинстве случаев мы не рекомендуем использовать другие варианты. Если ваше приложение уже использует эти параметры, мы рекомендуем по возможности перейти на OAuth 2.0.

Если у вашего приложения есть определенные необычные требования к авторизации, такие как вход в систему одновременно с запросом доступа к данным ( гибрид ) или делегирование полномочий на уровне домена ( 2LO ), то в настоящее время вы не можете использовать токены OAuth 2.0. В таких случаях вместо этого вам необходимо использовать токены OAuth 1.0.

Авторизация запросов с помощью OAuth 2.0

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

Детали процесса авторизации или «потока» для OAuth 2.0 несколько различаются в зависимости от того, какое приложение вы пишете. Следующий общий процесс применим ко всем типам приложений:

  1. Когда вы создаете свое приложение, вы регистрируете его в Google . Затем Google предоставляет информацию, которая понадобится вам позже, например идентификатор клиента и секрет клиента.
  2. Когда вашему приложению требуется доступ к пользовательским данным, оно запрашивает у Google определенный объем доступа.
  3. Google отображает пользователю диалоговое окно OAuth с просьбой разрешить вашему приложению запрашивать некоторые из его данных.
  4. Если пользователь одобряет, Google предоставляет вашему приложению кратковременный токен доступа .
  5. Ваше приложение запрашивает пользовательские данные, прикрепляя к запросу токен доступа.
  6. Если Google определит, что ваш запрос и токен действительны, он вернет запрошенные данные.

Некоторые потоки включают дополнительные шаги, например использование токенов обновления для получения новых токенов доступа. Подробную информацию о потоках для различных типов приложений см. в документации Google OAuth 2.0 .

Ниже представлена ​​информация об области действия OAuth 2.0 для API Blogger GData:

https://www.blogger.com/feeds/

Чтобы запросить доступ с помощью OAuth 2.0, вашему приложению необходима информация об области действия, а также информация, которую Google предоставляет при регистрации приложения (например, идентификатор клиента и/или секрет клиента).

Совет: Клиентские библиотеки API Google могут выполнить за вас часть процесса авторизации. Они доступны для различных языков программирования; для получения более подробной информации посетите страницу «Библиотеки и образцы» .

Указание версии

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

Чтобы указать номер версии, используйте HTTP-заголовок GData-Version :

GData-Version: 2

Альтернативно, если вы не можете установить заголовки HTTP, вы можете указать v=2 в качестве параметра запроса в URL-адресе. Но HTTP-заголовок предпочтителен там, где это возможно.

Примечание . Клиентские библиотеки автоматически предоставляют соответствующие заголовки версий, поэтому не используйте параметр запроса v=2 при использовании клиентской библиотеки.

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

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

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

https://www.blogger.com/feeds/profileID/blogs

Где идентификатор профиля — это номер в URL-адресе страницы профиля пользователя.

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

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

<entry gd:etag='W/"D08FQn8-eip7ImA9WxZbFEw."'>
  <id>tag:blogger.com,1999:user-userNumber.blog-blogID</id>
  <published>2006-08-02T18:44:43.089-07:00</published>
  <updated>2008-04-17T00:03:33.152-07:00</updated>
  <title>Lizzy's Diary</title>
  <summary type='html'>Being the journal of Elizabeth Bennet</summary>
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/profileID/blogs/blogID' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/' />
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default' />
  ...
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>noreply@blogger.com</email>
  </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 этого элемента, который имеет следующий формат:

https://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://www.w3.org/2007/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 https://www.blogger.com/feeds/blogID/posts/default

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

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

<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet href="http://www.blogger.com/styles/atom.css"
  type="text/css"?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"D08FQn8-eip7ImA9WxZbFEw."'>
  <id>tag:blogger.com,1999:blog-blogID</id>
  <updated>2008-04-17T00:03:33.152-07:00</updated>
  <title>Lizzy's Diary</title>
  <subtitle type='html'></subtitle>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default' />
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/' />
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>noreply@blogger.com</email>
  </author>
  <generator version='7.00'
    uri='http://www2.blogger.com'>Blogger</generator>
  <entry gd:etag='W/"D0YHRn84eip7ImA9WxZUFk8."'>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <published>2008-04-07T20:25:00.005-07:00</published>
    <updated>2008-04-07T20:25:37.132-07:00</updated>
    <title>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='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/posts/default/postID' />
    <link rel='self' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/posts/default/postID' />
    <link rel='alternate' type='text/html'
      href='http://blogName.blogspot.com/2008/04/quite-disagreeable.html' />
    <author>
      <name>Elizabeth Bennet</name>
      <uri>http://www.blogger.com/profile/profileID</uri>
      <email>noreply@blogger.com</email>
    </author>
  </entry>
</feed>

Повторное получение сообщения в блоге

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

Чтобы выполнить такой условный поиск, отправьте запрос HTTP GET , который включает заголовок HTTP If-None-Match . В заголовке укажите ETag записи, который можно найти в атрибуте gd:etag элемента <entry> .

Например:

If-None-Match: W/"D08FQn8-eil7ImA9WxZbFEw."

Когда Blogger получает этот запрос, он проверяет, имеет ли запрошенная вами запись тот же ETag, что и указанный вами ETag. Если ETags совпадают, значит, запись не изменилась, и Blogger возвращает код состояния HTTP 304 Not Modified .

Если ETags не совпадают, значит, запись была изменена с момента последнего запроса, и Blogger возвращает ее.

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

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

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

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

GET https://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
Указывает категории (также известные как метки) для фильтрации результатов ленты. Например, https://www.blogger.com/feeds/ blogID /posts/default/-/Fritz/Laurie возвращает записи с метками Fritz и Laurie .
максимальные результаты
Максимальное количество возвращаемых записей.
Сортировать по
Порядок возврата записей, например lastmodified (по умолчанию), starttime или updated .
опубликованный минимум, опубликованный максимум
Границы дат публикации записей.
стартовый индекс
Индекс первого результата, отсчитываемого от 1 (для разбиения по страницам).
обновленный минимум, обновленный максимум
Границы дат обновления записей. Эти параметры запроса игнорируются, если для параметра orderby не установлено значение updated .
путь
Путь постоянной ссылки на сообщение. Например, для публикации с URL-адресом http://buzz.blogger.com/2011/08/bloggers-fresh-new-look.html путь постоянной ссылки — /2011/08/bloggers-fresh-new-look.html .
д
Полнотекстовая строка запроса. Это позволяет вам искать в блоге сообщения, соответствующие запросу.

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

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

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

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

<entry gd:etag='W/"CUYDSXo8fSp7ImA9WB9UFkU."'>
  <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 https://www.blogger.com/feeds/blogID/postID/comments/default

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

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

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

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

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

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

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

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

<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet href="http://www.blogger.com/styles/atom.css"
  type="text/css"?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearch/1.1/'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"CUYMQ348fyp7ImA9WB9UFkU."'>
  <id>tag:blogger.com,1999:blog-blogID.postpostID..comments</id>
  <updated>2007-12-14T17:46:22.077-08:00</updated>
  <title>Comments on Lizzy's Diary: Quite disagreeable</title>
  <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://www.blogger.com/feeds/blogID/postID/comments/default' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html' />
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>noreply@blogger.com</email>
  </author>
  <generator version='7.00'
    uri='http://www.blogger.com'>Blogger</generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <entry gd:etag='W/"CUYCQX47eSp7ImA9WB9UFkU."'>
    <id>tag:blogger.com,1999:blog-blogID.post-commentID</id>
    <published>2007-12-14T17:46:00.001-08:00</published>
    <updated>2007-12-14T17:46:00.001-08:00</updated>
    <title>Darcy FTW!</title>
    <content type='html'>Darcy FTW!</content>
    <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/postID/comments/default/commentID' />
    <link rel='self' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/postID/comments/default/commentID' />
    <link rel='alternate' type='text/html'
      href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html?showComment=1197683160001#ccommentID'
      title='' />
    <author>
      <name>Elizabeth Bennet</name>
      <uri>http://www.blogger.com/profile/profileID</uri>
      <email>liz@gmail.com</email>
    </author>
    <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0'
      href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html'
      ref='tag:blogger.com,1999:blog-blogID.post-postID'
      source='http://www.blogger.com/feeds/blogID/posts/default/postID'
      type='text/html' />
  </entry>
</feed>

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

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

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

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

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

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

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

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

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

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

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

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