Bu sayfa, Cloud Translation API ile çevrilmiştir.

Blogger API: API'yi kullanma

Blogger API'si, REST API'leri kullanarak Blogger içeriğini uygulamanızla entegre etmenizi sağlar. Başlamadan önce yetkilendirme ayarlarını yapmanız gerekir.

Giriş

Bu belge, Blogger API ile etkileşim kurabilecek uygulamalar yazmak isteyen geliştiricilere yöneliktir. Blogger, kullanıcıların düşüncelerini sürekli olarak yayınlamalarına olanak tanıyan web siteleri oluşturmaya yönelik bir araçtır.

Blogger kavramlarına aşina değilseniz kodlamaya başlamadan önce Başlarken bölümünü okumalısınız.

İstekleri yetkilendirme ve uygulamanızı tanımlama

Uygulamanızın Blogger API'lerine gönderdiği her isteğin, uygulamanızı Google'a tanımlaması gerekir. Uygulamanızı tanımlamanın iki yolu vardır: OAuth 2.0 jetonu (isteği de yetkilendirir) ve/veya uygulamanın API anahtarını kullanmak. Bu seçeneklerden hangisinin kullanılacağını nasıl belirleyeceğiniz aşağıda açıklanmıştır:

İstek, yetkilendirme gerektiriyorsa (örneğin, bir kişinin özel verilerine yönelik istek), uygulamanın istekle birlikte bir OAuth 2.0 jetonu sağlaması gerekir. Uygulama da API anahtarını sağlayabilir, ancak bu zorunlu değildir.
İstek, yetkilendirme gerektirmiyorsa (örneğin, herkese açık veri isteği) uygulamanın, sizin için en uygun seçenek olan API anahtarını veya OAuth 2.0 jetonunu ya da her ikisini de sağlaması gerekir.

Yetkilendirme protokolleri hakkında

Uygulamanız, istekleri yetkilendirmek için OAuth 2.0 kullanmalıdır. Başka hiçbir yetkilendirme protokolü desteklenmez. Uygulamanız Google ile Oturum Açma özelliğini kullanıyorsa yetkilendirme işleminin bazı kısımları sizin adınıza gerçekleştirilir.

OAuth 2.0 kullanarak istekleri yetkilendirme

Herkese açık olmayan kullanıcı verileri için Blogger API'lerine yapılan istekler, kimliği doğrulanmış bir kullanıcı tarafından yetkilendirilmelidir.

Bu işlem, bir OAuth istemci kimliğiyle gerçekleştirilir.

veya Kimlik Bilgileri sayfasında bir tane oluşturun.

OAuth 2.0 ile yetkilendirme işleminin ("akış") ayrıntıları, yazdığınız uygulamanın türüne bağlı olarak değişiklik gösterir. Aşağıdaki genel işlem tüm uygulama türleri için geçerlidir:

Uygulamanız kullanıcı verilerine erişmesi gerektiğinde Google'dan belirli bir erişim kapsamı ister.
Google, kullanıcıya uygulamanızı kullanıcının verilerinden bazılarını istemeye yetkilendirmesi için bir onay ekranı gösterir.
Kullanıcı onaylarsa Google, uygulamanıza kısa süreli bir erişim jetonu verir.
Uygulamanız, erişim jetonunu isteğe ekleyerek kullanıcı verileri için istekte bulunur.
Google, isteğinizin ve jetonun geçerli olduğuna kanaat getirirse istenen verileri döndürür.

Bazı akışlarda başka adımlar da yer alır. Örneğin, yeni erişim jetonları almak için yenileme jetonları kullanmak. Farklı uygulama türlerine yönelik akışlar hakkında ayrıntılı bilgi için Google'ın OAuth 2.0 dokümanlarına bakın.

Blogger API'leri için OAuth 2.0 kapsam bilgileri aşağıda verilmiştir:

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

Uygulamanızın OAuth 2.0 kullanarak erişim isteğinde bulunabilmesi için hem kapsam bilgilerine hem de uygulamanızı kaydederken Google tarafından sağlanan bilgilere (ör. istemci kimliği ve istemci gizli anahtarı) ihtiyacı vardır.

İpucu: Google API'leri istemci kitaplıkları, yetkilendirme işleminin bazı adımlarını sizin yerinize gerçekleştirebilir. Bu kitaplıklar çeşitli programlama dilleri için kullanıma sunulmuştur. Ayrıntılar için kitaplıkların ve örneklerin bulunduğu sayfayı inceleyin.

API anahtarı edinme ve kullanma

Herkese açık veriler için Blogger API'lerine yapılan isteklerle birlikte, API anahtarı veya erişim jetonu olabilen bir tanımlayıcı bulunmalıdır.

veya Kimlik Bilgileri sayfasında bir tane oluşturun.

Bir API anahtarınız olduktan sonra, uygulamanız tüm istek URL'lerine key=yourAPIKey sorgu parametresini ekleyebilir.

API anahtarı, URL'lere yerleştirmek için güvenlidir; herhangi bir kodlama yapmanız gerekmez.

Bloglarla çalışma

Blog alma

Blogun URI'sine HTTP GET isteği göndererek belirli bir blogla ilgili bilgileri alabilirsiniz. Bir blogun URI'si aşağıdaki biçimdedir:

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

İstek

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

Herkese açık bir blog almak için kullanıcının kimliğinin doğrulanmasına gerek yoktur. Uygulamanın herkese açık blog isteği için Authorization HTTP üst bilgisi içermesi gerekmez ancak API anahtarını sağlamanız gerekir.

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve blog verileriyle yanıt verir:

{
  "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": ""
  }
}

Bir blogu URL'siyle alma

Aşağıdaki URI'ye url parametresiyle HTTP GET isteği göndererek bir blogu URL'sini kullanarak alabilirsiniz:

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

İstek

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

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve tanımlanan blog'un tam temsili ile yanıt verir:

{
 "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": ""
 }
}

Bir kullanıcının bloglarını alma

Blog toplama URI'sine bir HTTP GET isteği göndererek bir kullanıcının bloglarının listesini alabilirsiniz:

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

İstek

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

Not: Kullanıcının kendi bloglarını listelemesi için kimliği doğrulanmalıdır. Bu nedenle, Authorization HTTP üst bilgisini GET isteğini sağlamanız gerekir.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve kullanıcının blogları listesinin tam temsili ile yanıt verir:

{
  "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": ""
      }
    }
  ]
}

Yayınlarla çalışma

Blogdan yayın alma

Yayın koleksiyonu URI'sine GET isteği göndererek belirli bir blog'daki yayın listesini alabilirsiniz. Bir yayın koleksiyonunun URI'si aşağıdaki biçimdedir:

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

İstek

Örnek:

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

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yayın listesiyle yanıt verir:

{
  "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
    }
  ]
}

Belirli bir yayını alma

Yayın kaynağı URI'sine GET isteği göndererek bir blog'daki belirli bir yayını alabilirsiniz. Bir yayın kaynağının URI'si aşağıdaki biçimdedir:

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

İstek

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

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yayının içeriğiyle yanıt verir:

{
  "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"
  }
}

Yayın arama

Bir blogdaki yayınları aramak için, q arama sorgusu parametresiyle birlikte yayın arama URI'sine GET isteği gönderebilirsiniz:

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

İstek

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

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yayının içeriğiyle yanıt verir:

{
  "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"
    }
  },
  ...
  ]
}

Yayın ekleme

Yayın JSON gövdesiyle yayın koleksiyonu URI'sine POST isteği göndererek bir blog için yayın ekleyebilirsiniz:

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

İstek

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..."
}

Gönderi oluşturabilmek için kimliğinizi doğrulamanız gerekir.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yayının içeriğiyle yanıt verir:

{
 "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"
 }
}

Yayın silme

Yayın kaynağı URI'sine DELETE isteği göndererek bir blog yayınını silebilirsiniz:

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

İstek

Örnek:

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

Bir yayını silmek için kimliğinizin doğrulanmış olması gerekir.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum koduyla yanıt verir.

Bir yayın, yoluyla alınıyor

path parametresiyle posts bypath URI'sine GET isteği göndererek bir blogdan yayın alabilirsiniz. Yola göre yayın isteğine ilişkin URI aşağıdaki biçimdedir:

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

İstek

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

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yayının içeriğiyle yanıt verir:

{
  "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"
  }
}

Yayını güncelleme

Bir blog yayınını, yayın JSON gövdesine sahip yayın kaynağı URI'sine PUT isteği göndererek güncelleyebilirsiniz:

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

İstek

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..."
}

Bir yayını güncellemek için kimliğinizin doğrulanması gerekir.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yayının içeriğiyle yanıt verir:

{
 "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"
 }
}

Yama anlamıyla bir yayını güncelleme

Post JSON gövdesiyle birlikte yayın kaynağı URI'sına PATCH isteği göndererek bir yayını yama anlamıyla güncelleyebilirsiniz:

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

İstek

Örnek:

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..."
}

Bir yayını güncellemek için kimliğinizin doğrulanması gerekir.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yayının içeriğiyle yanıt verir:

{
 "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"
 }
}

Yorumlarla çalışma

Yayına yorum alma

Yorum toplama URI'sine GET isteği göndererek bir yayına ait yorum listesini alabilirsiniz. Yorum koleksiyonunun URI'si aşağıdaki biçimdedir:

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

İstek

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

"Herkese açık bir blog almak için kullanıcının kimliğinin doğrulanmasına gerek yoktur. Uygulamanın herkese açık blog isteği için Authorization HTTP üst bilgisi içermesi gerekmez ancak API anahtarını sağlamanız gerekir.

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yorum listesiyle yanıt verir:

{
  "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
    }
  ]
}

Belirli bir yorumu alma

Yorum kaynağı URI'sına GET isteği göndererek bir yayından belirli bir yorumu alabilirsiniz. Yorum kaynağının URI'si aşağıdaki biçimdedir:

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

İstek

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

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve yorum verileriyle yanıt verir:

{
  "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"
    }
  }
}

Sayfalarla çalışma

Blog sayfalarını alma

Sayfa koleksiyon URI'sine GET isteği göndererek bir bloga ait sayfa listesini alabilirsiniz. Sayfa koleksiyonunun URI'si aşağıdaki biçimdedir:

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

İstek

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

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve sayfa listesiyle yanıt verir:

{
  "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"
        }
      }
    }
  ]
}

Belirli bir sayfayı alma

Sayfa kaynak URI'sine GET isteği göndererek bir blogdan belirli bir sayfayı alabilirsiniz. Bir sayfanın URI'sı aşağıdaki biçimdedir:

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

İstek

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

Blogger'da, kimlik doğrulama gerektiren özel bloglar da vardır.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve sayfa verileriyle yanıt verir:

{
  "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"
    }
  }
}

Kullanıcılarla çalışma

Kullanıcı alınıyor

Kullanıcı kaynak URI'sine HTTP GET isteği göndererek kullanıcının bilgilerini alabilirsiniz:

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

İstek

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

Not: Kullanıcının kendi bilgilerini listeleyebilmesi için kullanıcının kimliği doğrulanmalıdır. Bu nedenle, Authorization HTTP üst bilgisini GET isteğini sağlamanız gerekir.

Yanıt

İstek başarılı olursa sunucu bir HTTP 200 OK durum kodu ve kullanıcının bloglarının listesinin bağlantısı ile yanıt verir:

{
  "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"
  }
}

Standart sorgu parametreleri

Aşağıdaki sorgu parametreleri, Blogger API'lerindeki tüm yöntemler ve tüm kaynaklarla kullanılabilir.

Tüm Blogger API'leri işlemleri için geçerli olan sorgu parametreleri, Sistem Parametreleri bölümünde belgelenmiştir.