중요: 이 페이지는 이전 버전입니다. 최신 버전의 경우 왼쪽 탐색 메뉴의 링크를 사용하세요.
이 문서에서는 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-min 및 updated-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 게시 프로토콜 문서에 정의된 <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>