참조 가이드

중요: 이 페이지는 이전 버전입니다. 최신 버전의 경우 왼쪽 탐색 메뉴에 있는 링크를 사용합니다.

이 문서에서는 Blogger Data API의 원시 프로토콜(XML 및 HTTP)에 대한 자세한 참조 문서를 제공합니다.

이 문서에는 프로그래밍 언어 클라이언트 라이브러리에 대한 정보가 포함되어 있지 않습니다. 클라이언트 라이브러리 참조 정보는 개발자 가이드의 프로그래밍 언어별 섹션에 있는 링크를 참고하세요.

콘텐츠

대상

이 문서는 Blogger와 상호작용할 수 있는 클라이언트 애플리케이션을 개발하려는 프로그래머를 대상으로 합니다.

이 문서는 참조 문서로 사용자가 개발자 가이드에 나와 있는 개념과 Google Data API 프로토콜에 나오는 일반적인 개념을 이해하고 있다고 가정합니다.

Blogger 피드 유형

Blogger에서는 전체 피드 및 요약 피드의 두 가지 블로그 콘텐츠 피드를 제공합니다. 전체 피드는 전체 블로그 게시물을 포함하고, 요약 피드는 각 게시물의 간단한 스니펫만 포함합니다.

블로그 소유자는 GUI 설정을 사용하여 블로그가 신디케이터와 애그리게이터에 전체 피드를 제공할지 또는 요약 피드를 제공할지 지정할 수 있습니다.

클라이언트 앱에서 피드에 인증되지 않은 요청을 보내면 블로그 소유자가 지정한 피드 유형이 수신됩니다.

그러나 클라이언트 앱에서 인증된 요청을 전송하면 블로그 소유자가 지정한 내용과 관계없이 항상 전체 피드를 수신합니다.

Blogger 쿼리 매개변수 참조

Blogger Data API는 거의 모든 표준 Google Data API 쿼리 매개변수를 지원합니다.

Blogger는 q(텍스트 검색) 및 author 매개변수를 지원하지 않습니다.

orderby 매개변수가 updated로 설정되지 않는 한 updated-minupdated-max 쿼리 매개변수는 무시됩니다. 예를 들어, 다음 URL은 2008년 3월 16일에서 2008년 3월 24일로 업데이트된 모든 블로그 게시물을 검색합니다.

http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated

Blogger 요소 참조 문서

Blogger Data API는 표준 Atom 요소만 사용합니다. 자세한 내용은 Atom 1.0 신디케이션 형식 사양Atom 게시 프로토콜을 참조하세요.

이 섹션의 나머지 부분에서는 Blogger의 일부 표준 요소 사용법에 대한 몇 가지 구체적인 참고사항을 제공합니다.

초안 항목

초안 블로그 항목은 Atom Publishing Protocol 문서에 정의된 <app:draft> 확장 프로그램 요소를 사용하여 표시됩니다. 초안 항목의 예는 다음과 같습니다.

<entry xmlns:app='http://purl.org/atom/app#'>
...
<app:control>
<app:draft>yes</app:draft>
</app:control>
</entry>

<draft> 요소를 지정하지 않으면 항목이 초안이 아닙니다.

발행일 및 업데이트 날짜

표준 Atom <published> 요소에 제공된 타임스탬프는 사용자가 Blogger GUI에서 설정할 수 있는 '게시 날짜'에 해당합니다.

클라이언트에서 새 항목을 만들 때 <published> 값을 지정하지 않으면 Blogger는 항목의 게시 날짜를 현재 서버 시간으로 설정합니다. 고객이 항목을 수정했지만 <published> 값을 지정하지 않은 경우 Blogger는 항목의 게시 날짜만 남겨 둡니다.

하지만 항목을 만들거나 수정할 때 클라이언트가 <published> 요소의 값을 지정하면 Blogger는 항목의 게시 날짜를 지정된 값으로 설정합니다. 원래 생성 날짜를 유지하는 동시에 다른 블로그 시스템에서 이전 항목을 가져오는 등의 작업에 유용합니다.

Blogger에서는 표준 Atom <updated> 요소를 사용하여 항목이 마지막으로 변경된 시점을 표시합니다. 클라이언트가 <updated> 값을 제어할 수 없습니다. 클라이언트가 항목을 게시하거나 수정할 때마다 Blogger는 항상 항목의 마지막 업데이트 날짜를 현재 서버 시간으로 설정합니다.

표준 Google Data API published-min, published-max, updated-min, updated-max 쿼리 매개변수를 사용하여 <published> 또는 <updated> 값에 따라 항목을 요청할 수 있습니다. 그러나 업데이트된 날짜의 쿼리에 대한 참고사항은 Blogger 쿼리 매개변수 참조를 확인하세요.

게시물에 댓글 연결하기

Blogger 내보내기 형식은 하나의 Atom 피드 문서에 게시물과 댓글 항목을 모두 포함합니다. 두 유형의 항목을 구분하기 위해 Blogger에서는 <atom:category> 요소를 사용합니다. 이 요소에는 항목이 게시물인지 댓글인지를 나타내는 term 매개변수가 있습니다.

또한 Atom 스레딩 확장 프로그램을 사용하여 댓글 항목을 속한 게시물 항목에 연결합니다. 아래 예시에서 댓글 항목의 <thr:in-reply-to> 요소는 ref 매개변수의 게시물 항목 식별자를 사용하여 게시물을 가리킵니다. 또한 href 매개변수를 통해 게시물의 HTML URL에 연결합니다.

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
      xmlns:thr="http://purl.org/syndication/thread/1.0">
  ...

  <-- A blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <content type="html">This is my first post</content>
    <link rel="alternate" type="text/html"
      href="http://blogName.blogspot.com/2007/04/first-post.html">
    </link>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#post"/>
    ...
  </entry>

  <-- A comment to the blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
    <content type="html">This is my first commment</content>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#comment"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     type="text/html"/>
    ...
  </entry>
</feed>

맨 위로