API Blogger: использование API

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

Введение

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

Если вы не знакомы с концепциями Blogger, вам следует прочитать «Начало работы» , прежде чем приступать к написанию кода.

Авторизация запросов и идентификация вашего приложения

Каждый запрос, который ваше приложение отправляет к API Blogger, должен идентифицировать ваше приложение для Google. Существует два способа идентифицировать ваше приложение: с помощью токена OAuth 2.0 (который также авторизует запрос) и/или с помощью ключа API приложения. Вот как определить, какой из этих вариантов использовать:

  • Если запрос требует авторизации (например, запрос личных данных человека), приложение должно предоставить вместе с запросом токен OAuth 2.0. Приложение также может предоставить ключ API, но это не обязательно.
  • Если запрос не требует авторизации (например, запрос общедоступных данных), то приложение должно предоставить либо ключ API, либо токен OAuth 2.0, либо и то, и другое — любой вариант, который вам наиболее удобен.

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

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

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

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

Этот процесс упрощается с помощью идентификатора клиента OAuth.

Получите идентификатор клиента OAuth

Или создайте его на странице «Учетные данные» .

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

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

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

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

https://www.googleapis.com/auth/blogger

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

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

Получение и использование ключа API

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

Получить ключ

Или создайте его на странице «Учетные данные» .

Получив ключ API, ваше приложение может добавить параметр запроса key= yourAPIKey ко всем URL-адресам запроса.

Ключ API можно безопасно встраивать в URL-адреса; ему не нужна никакая кодировка.

Работа с блогами

Получение блога

Вы можете получить информацию для определенного блога, отправив запрос HTTP GET на URI блога. URI для блога имеет следующий формат:

https://www.googleapis.com/blogger/v3/blogs/blogId

Запрос

GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY

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

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и данными блога:

{
  "kind": "blogger#blog",
  "id": "2399953",
  "name": "Blogger Buzz",
  "description": "The Official Buzz from Blogger at Google",
  "published": "2007-04-23T22:17:29.261Z",
  "updated": "2011-08-02T06:01:15.941Z",
  "url": "http://buzz.blogger.com/",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

Получение блога по его URL

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

https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url

Запрос

https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и полным представлением идентифицированного блога: 

{
 "kind": "blogger#blog",
 "id": "3213900",
 "name": "Blogger Developers Network",
 "description": "The official Blogger Developers Network weblog.",
 "published": "2007-02-09T10:13:10-08:00",
 "updated": "2012-04-15T19:38:01-07:00",
 "url": "http://code.blogger.com/",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900",
 "posts": {
  "totalItems": 55,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts"
 },
 "pages": {
  "totalItems": 1,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/pages"
 },
 "locale": {
  "language": "en",
  "country": "US",
  "variant": ""
 }
}

Получение блогов пользователей

Вы можете получить список блогов пользователя, отправив HTTP-запрос GET на URI коллекции блогов:

https://www.googleapis.com/blogger/v3/users/userId/blogs

Запрос

GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */

Примечание . Пользователь должен пройти аутентификацию, чтобы составить список своих собственных блогов, поэтому вы должны предоставить HTTP-заголовок Authorization в запросе GET .

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и полным представлением списка блогов пользователя:

{
  "kind": "blogger#blogList",
  "items": [
    {
      "kind": "blogger#blog",
      "id": "4967929378133675647",
      "name": "Brett's Test Blawg",
      "description": "",
      "published": "2010-10-06T23:33:31.662Z",
      "updated": "2011-08-08T06:50:02.005Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

Работа с постами

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

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

https://www.googleapis.com/blogger/v3/blogs/blogId/posts

Запрос

Вот пример:

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY

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

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и списком сообщений:

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "items": [
    {
      "kind": "blogger#post",
      "id": "7706273476706534553",
      "blog": {
        "id": "2399953"
      },
      "published": "2011-08-01T19:58:00.000Z",
      "updated": "2011-08-01T19:58:51.947Z",
      "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
      "title": "Latest updates, August 1st",
      "content": "elided for readability",
      "author": {
        "id": "401465483996",
        "displayName": "Brett Wiltshire",
        "url": "http://www.blogger.com/profile/01430672582309320414",
        "image": {
          "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
         }
      },
      "replies": {
        "totalItems": "0",
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

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

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

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Запрос

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY

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

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и содержимым сообщения:

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

Поиск сообщения

Вы можете искать сообщения в блоге, отправив запрос GET на URI поиска сообщений с параметром поискового запроса q:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms

Запрос

GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY

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

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и содержимым сообщения:

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ",
  "items": [
  {
    "kind": "blogger#post",
    "id": "1387873546480002228",
    "blog": {
      "id": "3213900"
    },
    "published": "2012-03-23T01:58:00-07:00",
    "updated": "2012-03-23T01:58:12-07:00",
    "url": "http://code.blogger.com/2012/03/blogger-documentation-has-moved-to.html",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228",
    "title": "Blogger Documentation has moved to developers.google.com",
    "content": "content elided for readability",
    "author": {
      "id": "16258312240222542576",
      "displayName": "Brett Morgan",
      "url": "http://www.blogger.com/profile/16258312240222542576",
      "image": {
        "url": "https://resources.blogblog.com/img/b16-rounded.gif"
      }
    },
    "replies": {
      "totalItems": "0",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228/comments"
    }
  },
  ...
  ]
}

Добавление сообщения

Вы можете добавить публикацию в блог, отправив запрос POST на URI коллекции публикаций с телом публикации в формате JSON:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/

Запрос

POST https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
  "kind": "blogger#post",
  "blog": {
    "id": "8070105920543249955"
  },
  "title": "A new post",
  "content": "With <b>exciting</b> content..."
}

Вы должны пройти аутентификацию, чтобы создать публикацию.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и содержимым сообщения:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "A new post",
 "content": "With <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

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

Вы можете удалить публикацию в блоге, отправив запрос DELETE на URI ресурса публикации:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Запрос

Вот пример:

DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058
Authorization: /* OAuth 2.0 token here */

Вы должны пройти аутентификацию, чтобы удалить сообщение.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK .

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

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

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path

Запрос

https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY

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

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и содержимым сообщения:

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

Обновление публикации

Вы можете обновить публикацию в блоге, отправив запрос PUT на URI ресурса публикации с телом публикации в формате JSON:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Запрос

PUT https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "kind": "blogger#post",
 "id": "3445355871727114160",
 "blog": {
  "id": "8070105920543249955"
 },
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content..."
}

Вы должны пройти аутентификацию, чтобы обновить публикацию.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и содержимым сообщения:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Обновление сообщения с семантикой патча

Вы можете обновить публикацию с помощью семантики исправления, отправив запрос PATCH на URI ресурса публикации с телом публикации в формате JSON:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Запрос

Вот пример:

PATCH https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "content": "With absolutely <b>fabulous</b> content..."
}

Вы должны пройти аутентификацию, чтобы обновить публикацию.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и содержимым сообщения:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With absolutely <b>fabulous</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Работа с комментариями

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

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

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments

Запрос

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY

«Пользователю не требуется проходить аутентификацию для получения общедоступного блога. Приложению не требуется включать HTTP-заголовок Authorization для запроса общедоступного блога; однако вам необходимо предоставить ключ API.

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и списком комментариев:

{
  "kind": "blogger#commentList",
  "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ",
  "prevPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ",
  "items": [
    {
       "kind": "blogger#comment",
       "id": "9200761938824362519",
       "post": {
         "id": "6069922188027612413"
       },
       "blog": {
         "id": "2399953"
       },
       "published": "2011-07-28T19:19:57.740Z",
       "updated": "2011-07-28T21:29:42.015Z",
       "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
       "content": "elided",
       "author": {
         "id": "530579030283",
         "displayName": "elided",
         "url": "elided",
         "image": {
           "url": "elided"
         }
       }
    },
    {
      "kind": "blogger#comment",
      "id": "400101178920857170",
      elided for readability
    }
  ]
}

Получение определенного комментария

Вы можете получить конкретный комментарий из сообщения, отправив запрос GET на URI ресурса комментариев. URI для ресурса комментариев имеет следующий формат:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId

Запрос

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY

«Пользователю не требуется проходить аутентификацию для получения общедоступного блога. Приложению не требуется включать HTTP-заголовок Authorization для запроса общедоступного блога; однако вам необходимо предоставить ключ API.

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и данными комментария:

{
  "kind": "blogger#comment",
  "id": "9200761938824362519",
  "post": {
    "id": "6069922188027612413"
  },
  "blog": {
    "id": "2399953"
  },
  "published": "2011-07-28T19:19:57.740Z",
  "updated": "2011-07-28T21:29:42.015Z",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "content": "elided",
  "author": {
    "id": "530579030283",
    "displayName": "elided",
    "url": "elided",
    "image": {
      "url": "elided"
    }
  }
}

Работа со страницами

Получение страниц для блога

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

https://www.googleapis.com/blogger/v3/blogs/blogId/pages

Запрос

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY

«Пользователю не требуется проходить аутентификацию для получения общедоступного блога. Приложению не требуется включать HTTP-заголовок Authorization для запроса общедоступного блога; однако вам необходимо предоставить ключ API.

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и списком страниц:

{
  "kind": "blogger#pageList",
  "items": [
    {
      "kind": "blogger#page",
      "id": "273541696466681878",
      "blog": {
        "id": "4967929378133675647"
      },
      "published": "2011-07-14T16:16:00.000Z",
      "updated": "2011-07-14T16:16:23.602Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878",
      "title": "Static Content",
      "content": "elided for readability",
      "author": {
        "id": "901569848744",
        "displayName": "brett",
        "url": "http://www.blogger.com/profile/16258312240222542576",
        "image": {
          "url": "https://resources.blogblog.com/img/b16-rounded.gif"
        }
      }
    }
  ]
}

Получение определенной страницы

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

https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId

Запрос

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY

«Пользователю не требуется проходить аутентификацию для получения общедоступного блога. Приложению не требуется включать HTTP-заголовок Authorization для запроса общедоступного блога; однако вам необходимо предоставить ключ API.

Blogger также имеет частные блоги, требующие аутентификации.

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и данными страницы:

{
  "kind": "blogger#page",
  "id": "273541696466681878",
  "blog": {
    "id": "4967929378133675647"
  },
  "published": "2011-07-14T16:16:00.000Z",
  "updated": "2011-07-14T16:16:23.602Z",
  "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878",
  "title": "Static Content",
  "content": "elided for readability",
  "author": {
    "id": "901569848744",
    "displayName": "brett",
    "url": "http://www.blogger.com/profile/16258312240222542576",
    "image": {
      "url": "https://resources.blogblog.com/img/b16-rounded.gif"
    }
  }
}

Работа с пользователями

Получение пользователя

Вы можете получить информацию о пользователе, отправив запрос HTTP GET на URI ресурса пользователя:

https://www.googleapis.com/blogger/v3/users/userId

Запрос

GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */

Примечание . Пользователь должен пройти аутентификацию, чтобы указать свою собственную информацию, поэтому вы должны предоставить HTTP-заголовок Authorization вместе с запросом GET .

Ответ

Если запрос успешен, сервер отвечает кодом состояния HTTP 200 OK и ссылкой на список блогов пользователя:

{
  "kind": "blogger#user",
  "id": "901569848744",
  "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744",
  "blogs": {
    "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744/blogs"
  }
}

Стандартные параметры запроса

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

Параметры запроса, применимые ко всем операциям API Blogger, описаны в разделе «Системные параметры» .