Blogger API: API 사용

Blogger API를 사용하면 REST API를 사용하여 Blogger 콘텐츠를 애플리케이션과 통합할 수 있습니다. 시작하기 전에 승인을 설정해야 합니다.

소개

이 문서는 Blogger API와 상호작용할 수 있는 애플리케이션을 작성하려는 개발자를 대상으로 합니다. Blogger는 사람들이 자신의 생각을 꾸준히 게시할 수 있는 웹사이트를 만드는 도구입니다.

Blogger 개념에 익숙하지 않은 경우 코딩을 시작하기 전에 시작하기를 읽어 보세요.

요청 승인 및 애플리케이션 식별

애플리케이션에서 Blogger API로 전송하는 모든 요청은 Google에 애플리케이션을 식별해야 합니다. 애플리케이션을 식별하는 방법에는 OAuth 2.0 토큰을 사용하거나(이 토큰은 요청도 승인함) 애플리케이션의 API 키를 사용하는 두 가지 방법이 있습니다. 다음과 같은 방법으로 사용할 옵션을 결정합니다.

  • 요청에 승인이 필요한 경우 (예: 개별 사용자의 비공개 데이터 요청) 애플리케이션은 요청과 함께 OAuth 2.0 토큰을 제공해야 합니다. 애플리케이션은 API 키를 제공할 수도 있지만 꼭 그럴 필요는 없습니다.
  • 요청에 승인이 필요하지 않은 경우(예: 공개 데이터 요청) 애플리케이션은 API 키 또는 OAuth 2.0 토큰 중 하나 또는 둘 다를 편의에 따라 제공해야 합니다.

승인 프로토콜 정보

요청을 승인하려면 애플리케이션에서 OAuth 2.0을 사용해야 합니다. 다른 승인 프로토콜은 지원되지 않습니다. 애플리케이션에서 Google 계정으로 로그인을 사용하는 경우 승인의 일부 절차는 자동으로 처리됩니다.

OAuth 2.0을 사용하여 요청 승인

Blogger API에 대한 비공개 사용자 데이터 요청은 인증된 사용자의 승인을 받아야 합니다.

이 프로세스는 OAuth 클라이언트 ID를 통해 이루어집니다.

OAuth 클라이언트 ID 가져오기

또는 사용자 인증 정보 페이지에서 사용자 인증 정보를 만드세요.

OAuth 2.0의 승인 과정 세부사항('흐름')은 만들고 있는 애플리케이션의 종류에 따라 다소 다릅니다. 다음의 일반적인 과정은 모든 애플리케이션 유형에 적용됩니다.

  1. 사용자 데이터에 액세스해야 하는 애플리케이션은 Google에 특정 액세스 범위를 요청합니다.
  2. Google에서 사용자에게 애플리케이션의 데이터 요청을 승인할 것인지 물어보는 동의 화면을 표시합니다.
  3. 사용자가 승인하면 Google에서 애플리케이션에 제한 시간이 있는 단기 액세스 토큰을 제공합니다.
  4. 애플리케이션에서 액세스 토큰을 첨부하여 사용자 데이터를 요청합니다.
  5. Google에서 사용자의 요청과 토큰이 유효하다고 판단하면 요청된 데이터를 반환합니다.

일부 흐름에는 새로운 액세스 토큰을 얻기 위해 갱신 토큰을 사용하는 등의 추가 단계가 포함됩니다. 다양한 유형의 애플리케이션 흐름에 관한 자세한 내용은 Google의 OAuth 2.0 문서를 참조하세요.

다음은 Blogger API의 OAuth 2.0 범위 정보입니다.

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

OAuth 2.0을 사용하여 액세스를 요청하려면 애플리케이션에 범위 정보와 함께 애플리케이션을 등록할 때 Google에서 제공하는 정보(예: 클라이언트 ID, 클라이언트 보안 비밀)가 필요합니다.

팁: Google API 클라이언트 라이브러리가 사용자를 대신하여 일부 승인 과정을 처리할 수 있습니다. 여러 가지 프로그래밍 언어로 제공되므로 자세한 내용은 라이브러리 및 샘플 페이지를 참조하세요.

API 키 획득 및 사용

Blogger API에 대한 공개 데이터 요청에는 식별자가 함께 제공되어야 합니다. 식별자는 API 키 또는 액세스 토큰일 수 있습니다.

키 가져오기

또는 사용자 인증 정보 페이지에서 사용자 인증 정보를 만드세요.

API 키가 있으면 애플리케이션은 모든 요청 URL에 쿼리 매개변수 key=yourAPIKey를 추가할 수 있습니다.

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

공개 블로그를 검색하기 위해 사용자는 인증을 받지 않아도 됩니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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이 url와 함께 다음 URI에 HTTP GET 요청을 전송하여 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": ""
 }
}

사용자의 블로그 검색

블로그 컬렉션 URI에 HTTP GET 요청을 전송하여 사용자의 블로그 목록을 검색할 수 있습니다.

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 */

참고: 본인 소유의 블로그를 나열하려면 사용자가 인증되어야 하므로 GET 요청과 함께 Authorization HTTP 헤더를 제공해야 합니다.

응답

요청이 성공하면 서버가 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": ""
      }
    }
  ]
}

게시물 사용하기

블로그에서 게시물 가져오기

게시물 컬렉션 URI에 GET 요청을 전송하여 특정 블로그에서 게시물 목록을 검색할 수 있습니다. 게시물 컬렉션의 URI 형식은 다음과 같습니다.

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

요청

예를 들면 다음과 같습니다.

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

공개 블로그를 검색하기 위해 사용자는 인증을 받지 않아도 됩니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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
    }
  ]
}

특정 게시물 검색

게시물 리소스 URI에 GET 요청을 전송하여 블로그에서 특정 게시물을 검색할 수 있습니다. 게시물 리소스의 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

공개 블로그를 검색하기 위해 사용자는 인증을 받지 않아도 됩니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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"
  }
}

게시물 검색

q 검색어 매개변수와 함께 게시물 검색 URI에 GET 요청을 전송하여 블로그의 게시물을 검색할 수 있습니다.

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

공개 블로그를 검색하기 위해 사용자는 인증을 받지 않아도 됩니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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"
    }
  },
  ...
  ]
}

게시물 추가

게시물 JSON 본문과 함께 게시물 컬렉션 URI에 POST 요청을 전송하여 블로그에 게시물을 추가할 수 있습니다.

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

게시물 삭제

게시물 리소스 URI에 DELETE 요청을 전송하여 블로그의 게시물을 삭제할 수 있습니다.

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 상태 코드로 응답합니다.

경로를 통해 게시물 검색

path 매개변수와 함께 게시물 우회 URI에 GET 요청을 전송하여 블로그에서 게시물을 검색할 수 있습니다. 경로별 게시물의 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

공개 블로그를 검색하기 위해 사용자는 인증을 받지 않아도 됩니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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"
  }
}

게시물 업데이트

게시물 JSON 본문과 함께 게시물 리소스 URI에 PUT 요청을 전송하여 블로그의 게시물을 업데이트할 수 있습니다.

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

패치 시맨틱스를 사용하여 게시물 업데이트

게시물 JSON 본문과 함께 게시물 리소스 URI에 PATCH 요청을 전송하여 패치 시맨틱스로 게시물을 업데이트할 수 있습니다.

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

댓글 사용하기

게시물에 댓글 가져오기

댓글 컬렉션 URI에 GET 요청을 전송하여 게시물의 댓글 목록을 검색할 수 있습니다. 댓글 컬렉션의 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

'사용자는 공개 블로그를 검색할 때 인증이 필요하지 않습니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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
    }
  ]
}

특정 댓글 검색

댓글 리소스 URI에 GET 요청을 전송하여 게시물에서 특정 댓글을 검색할 수 있습니다. 댓글 리소스의 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

'사용자는 공개 블로그를 검색할 때 인증이 필요하지 않습니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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"
    }
  }
}

페이지 작업

블로그에 페이지 검색

페이지 컬렉션 URI에 GET 요청을 전송하여 블로그의 페이지 목록을 검색할 수 있습니다. 페이지 컬렉션의 URI 형식은 다음과 같습니다.

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

요청

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

'사용자는 공개 블로그를 검색할 때 인증이 필요하지 않습니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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"
        }
      }
    }
  ]
}

특정 페이지 가져오기

페이지 리소스 URI에 GET 요청을 전송하여 블로그에서 특정 페이지를 검색할 수 있습니다. 페이지 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

'사용자는 공개 블로그를 검색할 때 인증이 필요하지 않습니다. 애플리케이션은 공개 블로그 요청에 Authorization HTTP 헤더를 포함할 필요가 없습니다. 하지만 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"
    }
  }
}

사용자 작업

사용자 검색

사용자 리소스 URI에 HTTP GET 요청을 전송하여 사용자 정보를 검색할 수 있습니다.

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

요청

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

참고: 사용자는 본인 정보를 나열하려면 인증을 받아야 하므로 Authorization HTTP 헤더에 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"
  }
}

표준 쿼리 매개변수

다음 쿼리 매개변수는 Blogger API의 모든 메서드 및 리소스에 사용할 수 있습니다.

모든 Blogger API 작업에 적용되는 쿼리 매개변수는 시스템 매개변수에 설명되어 있습니다.