Blogger API: Menggunakan API

Blogger API memungkinkan Anda mengintegrasikan konten Blogger dengan aplikasi Anda menggunakan REST API. Sebelum memulai, Anda perlu menyiapkan otorisasi.

Pengantar

Dokumen ini ditujukan bagi developer yang ingin menulis aplikasi yang dapat berinteraksi dengan Blogger API. Blogger adalah alat untuk membuat situs yang memungkinkan orang memublikasikan pendapat mereka secara berkelanjutan.

Jika Anda belum memahami konsep Blogger, Anda harus membaca Memulai sebelum memulai coding.

Memberi otorisasi permintaan dan mengidentifikasi aplikasi Anda

Setiap permintaan yang dikirimkan 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 API key aplikasi. Berikut ini cara menentukan opsi mana yang akan digunakan:

  • Jika permintaan memerlukan otorisasi (seperti permintaan untuk data pribadi individu), aplikasi harus menyediakan token OAuth 2.0 bersama permintaan tersebut. Aplikasi juga dapat menyediakan kunci API, tetapi tidak harus menyediakannya.
  • Jika permintaan tidak memerlukan otorisasi (misalnya 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 diizinkan oleh pengguna yang diautentikasi.

Proses ini difasilitasi dengan client ID OAuth.

Mendapatkan client ID OAuth

Atau buat satu di halaman Credentials.

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:

  1. Saat memerlukan akses ke data pengguna, aplikasi Anda akan meminta cakupan akses tertentu kepada Google.
  2. Google menampilkan layar izin kepada pengguna, yang meminta mereka mengizinkan aplikasi Anda untuk meminta beberapa data.
  3. Jika pengguna menyetujui, Google akan memberikan token akses berumur singkat ke aplikasi Anda.
  4. Aplikasi Anda meminta data pengguna, dengan menambahkan token akses ke permintaan.
  5. 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 bisa berupa kunci API atau token akses.

Dapatkan Kunci

Atau buat satu di halaman Credentials.

Setelah 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 apa pun.

Bekerja dengan blog

Mengambil blog

Anda dapat mengambil informasi untuk blog tertentu dengan mengirimkan 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 diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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 berdasarkan 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/

Respons

Jika permintaan berhasil, server merespons dengan kode status HTTP 200 OK 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.

Respons

Jika permintaan berhasil, server merespons dengan kode status HTTP 200 OK dan representasi lengkap 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": ""
      }
    }
  ]
}

Menangani 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 ini contohnya:

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

Pengguna tidak perlu diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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 diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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 mengirimkan 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 diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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 mengirimkan 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.

Respons

Jika permintaan berhasil, server 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 mengirimkan permintaan DELETE ke URI resource postingan:

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

Permintaan

Berikut ini contohnya:

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

Anda harus diautentikasi untuk menghapus postingan.

Respons

Jika permintaan berhasil, server 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 diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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 mengirimkan 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.

Respons

Jika permintaan berhasil, server 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 ini 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.

Respons

Jika permintaan berhasil, server 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 pengumpulan komentar. URI untuk kumpulan 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 diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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 sebuah 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 diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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"
    }
  }
}

Menangani halaman

Mengambil halaman untuk blog

Anda dapat mengambil daftar halaman untuk blog dengan mengirimkan permintaan GET ke URI koleksi 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 diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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 diotentikasi untuk mengambil blog publik. Aplikasi tidak perlu menyertakan header HTTP Authorization untuk permintaan blog publik. Namun, Anda harus menyediakan kunci API.

Blogger juga memiliki blog pribadi, yang memerlukan autentikasi.

Respons

Jika permintaan berhasil, server 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 bersama pengguna

Mengambil pengguna

Anda dapat mengambil informasi pengguna dengan mengirim 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 informasinya sendiri, jadi Anda harus memberikan header HTTP Authorization dengan permintaan GET.

Respons

Jika permintaan berhasil, server 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 API Blogger didokumentasikan di Parameter Sistem.