중요: 2024년 9월 30일부터 v2.0 Google Data API에 대한 지원이 중단됩니다. 기능을 계속 사용하려면 v2.0 Google Data API를 사용하는 애플리케이션을 최신 API 버전으로 업데이트하세요. 최신 버전에서는 왼쪽 탐색 메뉴의 링크를 사용하세요. 참고: 일부 GET 요청 (예: 등록정보 게시물)은 피드 URL로 계속 지원되지만 동작에는 약간의 차이가 있습니다. 자세한 내용은 Blogger 도움말 문서를 참조하세요.
이 문서에서는 Blogger Data API의 원시 프로토콜(XML 및 HTTP)에 대한 자세한 참조 문서를 제공합니다.
이 문서에는 프로그래밍 언어 클라이언트 라이브러리에 대한 정보가 포함되어 있지 않습니다. 클라이언트 라이브러리 참조 정보는 개발자 가이드의 프로그래밍 언어별 섹션에 있는 링크를 확인하세요.
목차
대상
이 문서는 Blogger와 상호작용할 수 있는 클라이언트 애플리케이션을 작성하려는 프로그래머를 위해 작성되었습니다.
이 문서는 참조 문서이며 개발자 가이드에 제시된 개념과 Google 데이터 API 프로토콜의 일반적인 개념을 이해하고 있다고 가정합니다.
Blogger 피드 유형
Blogger에서는 피드에서 블로그 콘텐츠를 전체 피드 및 요약 피드라는 두 가지 방식으로 표현합니다. 전체 피드는 전체 블로그 게시물을 포함하지만 요약 피드는 각 게시물의 짧은 스니펫만 포함합니다.
블로그 소유자는 GUI 설정을 사용하여 블로그가 신디케이터와 애그리게이터에 전체 피드를 제공하는지 아니면 요약 피드를 제공할지 지정할 수 있습니다.
클라이언트 앱이 피드에 대한 인증되지 않은 요청을 보내면 블로그 소유자가 지정한 피드 유형을 수신합니다.
그러나 클라이언트 앱이 인증된 요청을 보내면 블로그 소유자가 지정한 것과 관계없이 항상 전체 피드를 수신합니다.
Blogger 쿼리 매개변수 참조
Blogger Data API는 거의 모든 표준 Google Data API 쿼리 매개변수를 지원합니다.
Blogger는 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://www.w3.org/2007/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/opensearch/1.1/"
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 comment</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>