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

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

Введение

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

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

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

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

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

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

Ваше приложение должно использовать OAuth 2.0 для авторизации запросов. Никакие другие протоколы авторизации не поддерживаются. Если ваше приложение использует Sign In With Google , некоторые аспекты авторизации выполняются за вас.

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

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

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

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

Или создайте его на странице Credentials .

Детали процесса авторизации или «потока» для 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 или токен доступа .

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

Или создайте его на странице Credentials .

Получив ключ 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, задокументированы в разделе Системные параметры .