Blogger API memungkinkan Anda mengintegrasikan konten Blogger dengan aplikasi menggunakan REST API. Sebelum memulai, Anda perlu menyiapkan otorisasi.
Pengantar
Dokumen ini ditujukan untuk developer yang ingin menulis aplikasi yang dapat berinteraksi dengan Blogger API. Blogger adalah alat untuk membuat situs yang memungkinkan orang memublikasikan pemikiran mereka secara berkelanjutan.
Jika Anda belum memahami konsep Blogger, sebaiknya baca Memulai sebelum mulai membuat kode.
Mengizinkan permintaan dan mengidentifikasi aplikasi Anda
Setiap permintaan yang dikirim aplikasi Anda ke Blogger API perlu mengidentifikasi aplikasi Anda ke Google. Ada dua cara untuk mengidentifikasi aplikasi Anda: menggunakan token OAuth 2.0 (yang juga mengizinkan permintaan) dan/atau menggunakan kunci API aplikasi. Berikut cara menentukan opsi yang akan digunakan:
- Jika permintaan memerlukan otorisasi (seperti permintaan data pribadi individu), aplikasi harus memberikan token OAuth 2.0 bersama permintaan tersebut. Aplikasi juga dapat menyediakan kunci API, tetapi tidak harus.
- Jika permintaan tidak memerlukan otorisasi (seperti permintaan data publik), aplikasi harus memberikan kunci API atau token OAuth 2.0, atau keduanya—opsi apa pun yang paling nyaman bagi Anda.
Tentang protokol otorisasi
Aplikasi Anda harus menggunakan OAuth 2.0 untuk mengizinkan permintaan. Tidak ada protokol otorisasi lain yang didukung. Jika aplikasi Anda menggunakan Login dengan Google, beberapa aspek otorisasi akan ditangani untuk Anda.
Mengizinkan permintaan dengan OAuth 2.0
Permintaan ke Blogger API untuk data pengguna non-publik harus diotorisasi oleh pengguna yang diautentikasi.
Proses ini difasilitasi dengan client ID OAuth.
Mendapatkan client ID OAuthAtau buat kredensial di halaman Kredensial.
Detail proses otorisasi, atau "alur", untuk OAuth 2.0 bervariasi bergantung pada jenis aplikasi yang Anda tulis. Proses umum berikut berlaku untuk semua jenis aplikasi:
- Saat memerlukan akses ke data pengguna, aplikasi Anda akan meminta cakupan akses tertentu kepada Google.
- Google menampilkan layar izin kepada pengguna, yang meminta mereka mengizinkan aplikasi Anda untuk meminta beberapa data.
- Jika pengguna menyetujui, Google akan memberikan token akses berumur singkat ke aplikasi Anda.
- Aplikasi Anda meminta data pengguna, dengan menambahkan token akses ke permintaan.
- Jika Google menentukan bahwa permintaan Anda dan token tersebut valid, data yang diminta akan ditampilkan.
Beberapa alur mencakup langkah tambahan, seperti penggunaan token refresh untuk memperoleh token akses baru. Informasi selengkapnya tentang alur untuk berbagai jenis aplikasi dapat dilihat di dokumentasi OAuth 2.0 Google.
Berikut adalah informasi cakupan OAuth 2.0 untuk Blogger API:
https://www.googleapis.com/auth/blogger
Untuk meminta akses menggunakan OAuth 2.0, aplikasi Anda memerlukan informasi cakupan, serta informasi yang disediakan oleh Google saat Anda mendaftarkan aplikasi (seperti ID klien dan rahasia klien).
Tips: Library klien Google API dapat menangani beberapa proses otorisasi secara otomatis. Library klien ini tersedia untuk berbagai bahasa pemrograman. Periksa halaman yang menjelaskan library beserta contohnya untuk mendapatkan informasi lebih mendetail.
Mendapatkan dan menggunakan kunci API
Permintaan ke Blogger API untuk data publik harus disertai dengan ID, yang dapat berupa kunci API atau token akses.
Dapatkan KunciAtau buat kredensial di halaman Kredensial.
Setelah Anda memiliki kunci API, aplikasi Anda dapat menambahkan parameter kueri key=yourAPIKey
ke semua URL permintaan.
Kunci API aman untuk disematkan dalam URL; tidak memerlukan encoding.
Bekerja dengan blog
Mengambil blog
Anda dapat mengambil informasi untuk blog tertentu dengan mengirim permintaan GET
HTTP ke URI blog. URI untuk blog memiliki
format berikut:
https://www.googleapis.com/blogger/v3/blogs/blogId
Permintaan
GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY
Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan data blog:
{ "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": "" } }
Mengambil blog melalui URL-nya
Anda dapat mengambil blog menggunakan URL-nya dengan mengirimkan permintaan GET
HTTP
ke URI berikut dengan parameter url
:
https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url
Permintaan
https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status 200 OK
HTTP dan representasi lengkap dari blog yang diidentifikasi:
{ "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": "" } }
Mengambil blog pengguna
Anda dapat mengambil daftar blog pengguna dengan mengirimkan permintaan GET
HTTP ke URI koleksi blog:
https://www.googleapis.com/blogger/v3/users/userId/blogs
Permintaan
GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */
Catatan: Pengguna harus diautentikasi untuk
mencantumkan blog mereka sendiri, jadi Anda harus memberikan header HTTP
Authorization
dengan permintaan GET
.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan representasi lengkap dari daftar blog
pengguna:
{ "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": "" } } ] }
Bekerja dengan postingan
Mengambil postingan dari blog
Anda dapat mengambil daftar postingan dari blog tertentu dengan mengirimkan
permintaan GET
ke URI koleksi postingan. URI untuk koleksi postingan memiliki format berikut:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts
Permintaan
Berikut contohnya:
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY
Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP 200 OK
dan daftar postingan:
{ "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 } ] }
Mengambil postingan tertentu
Anda dapat mengambil postingan tertentu dari blog dengan mengirimkan
permintaan GET
ke URI resource postingan. URI untuk resource
postingan memiliki format berikut:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Permintaan
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY
Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan konten postingan:
{ "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" } }
Menelusuri postingan
Anda dapat menelusuri postingan dari blog dengan mengirim permintaan GET
ke
URI penelusuran postingan dengan parameter kueri penelusuran q:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms
Permintaan
GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY
Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan konten postingan:
{ "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" } }, ... ] }
Menambahkan postingan
Anda dapat menambahkan postingan untuk blog dengan mengirim permintaan POST
ke
URI koleksi postingan dengan isi JSON postingan:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/
Permintaan
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..." }
Anda harus diautentikasi untuk membuat postingan.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan konten postingan:
{ "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" } }
Menghapus postingan
Anda dapat menghapus postingan untuk blog dengan mengirim permintaan DELETE
ke
URI resource postingan:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Permintaan
Berikut contohnya:
DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058 Authorization: /* OAuth 2.0 token here */
Anda harus diautentikasi untuk menghapus postingan.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP 200 OK
.
Mengambil postingan berdasarkan jalurnya
Anda dapat mengambil postingan dari blog dengan mengirimkan permintaan GET
ke
URI bypath postingan dengan parameter path
. URI untuk permintaan postingan menurut jalur memiliki format berikut:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path
Permintaan
https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY
Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan konten postingan:
{ "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" } }
Memperbarui postingan
Anda dapat memperbarui postingan untuk blog dengan mengirim permintaan PUT
ke
URI resource postingan dengan isi JSON postingan:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Permintaan
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..." }
Anda harus diautentikasi untuk memperbarui postingan.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan konten postingan:
{ "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" } }
Memperbarui Postingan dengan semantik patch
Anda dapat memperbarui postingan dengan semantik patch dengan mengirimkan permintaan PATCH
ke URI resource postingan dengan isi JSON postingan:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
Permintaan
Berikut contohnya:
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..." }
Anda harus diautentikasi untuk memperbarui postingan.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan konten postingan:
{ "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" } }
Menangani komentar
Mengambil komentar untuk postingan
Anda dapat mengambil daftar komentar untuk postingan dengan mengirim permintaan GET
ke URI koleksi komentar. URI untuk koleksi komentar memiliki format berikut:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments
Permintaan
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY
"Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP 200 OK
dan daftar komentar:
{ "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 } ] }
Mengambil komentar tertentu
Anda dapat mengambil komentar tertentu dari postingan dengan mengirimkan permintaan GET
ke URI resource komentar. URI untuk
resource komentar memiliki format berikut:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId
Permintaan
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY
"Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan data komentar:
{ "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" } } }
Bekerja dengan halaman
Mengambil halaman untuk blog
Anda dapat mengambil daftar halaman untuk blog dengan mengirimkan
permintaan GET
ke URI pengumpulan halaman. URI untuk koleksi halaman memiliki format berikut:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages
Permintaan
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY
"Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP 200 OK
dan daftar halaman:
{ "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" } } } ] }
Mengambil halaman tertentu
Anda dapat mengambil halaman tertentu dari blog dengan mengirimkan
permintaan GET
ke URI resource halaman. URI untuk Resource
halaman memiliki format berikut:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId
Permintaan
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY
"Pengguna tidak perlu diautentikasi untuk mengambil blog publik. Aplikasi
ini tidak perlu menyertakan header HTTP Authorization
untuk permintaan blog publik; namun, Anda harus menyediakan kunci API.
Blogger juga memiliki blog pribadi yang memerlukan autentikasi.
Tanggapan
Jika permintaan berhasil, server akan merespons dengan kode status HTTP
200 OK
dan data halaman:
{ "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" } } }
Bekerja sama dengan pengguna
Mengambil pengguna
Anda dapat mengambil informasi pengguna dengan mengirimkan permintaan GET
HTTP
ke URI resource pengguna:
https://www.googleapis.com/blogger/v3/users/userId
Permintaan
GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */
Catatan: Pengguna harus diautentikasi untuk
mencantumkan informasi mereka sendiri, jadi Anda harus memberikan header HTTP
Authorization
dengan permintaan GET
.
Tanggapan
Jika permintaan tersebut berhasil, server akan merespons dengan kode status HTTP
200 OK
dan link ke daftar blog
pengguna:
{ "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" } }
Parameter kueri standar
Parameter kueri berikut dapat digunakan dengan semua metode dan semua resource di Blogger API.
Parameter kueri yang berlaku untuk semua operasi Blogger API didokumentasikan di Parameter Sistem.