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 несколько различаются в зависимости от того, какое приложение вы пишете. Следующий общий процесс применим ко всем типам приложений:
- Когда вашему приложению требуется доступ к пользовательским данным, оно запрашивает у Google определенный объем доступа.
- Google отображает пользователю экран согласия , прося его разрешить вашему приложению запрашивать некоторые его данные.
- Если пользователь одобряет, Google предоставляет вашему приложению кратковременный токен доступа .
- Ваше приложение запрашивает пользовательские данные, прикрепляя к запросу токен доступа.
- Если 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, описаны в разделе «Системные параметры» .