개발자 가이드: 자바

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

Blogger Data API를 사용하면 클라이언트 애플리케이션에서 Google Data API 피드 형식으로 Blogger 콘텐츠를 확인하고 업데이트할 수 있습니다.

클라이언트 애플리케이션은 Blogger Data API를 사용하여 새 블로그 게시물을 만들고, 기존 블로그 게시물을 수정 또는 삭제하고, 특정 기준과 일치하는 블로그 게시물을 쿼리할 수 있습니다.

이 문서에서는 Blogger Data API의 기능에 대한 배경지식뿐만 아니라 자바 클라이언트 라이브러리를 사용하는 기본적인 Data API 상호작용의 예를 제공합니다. 라이브러리에서 사용하는 기본 프로토콜에 관해 자세히 알아보려면 이 개발자 가이드의 프로토콜 섹션을 참고하세요.

콘텐츠

  1. 잠재고객
  2. 시작하기
    1. Blogger 계정 만들기
    2. 샘플 코드 실행
  3. Blogger 서비스 인증
    1. AuthSub 프록시 인증
    2. ClientLogin 사용자 이름/비밀번호 인증
  4. 블로그 목록 가져오기
  5. 게시물 만들기
    1. 블로그 게시물 게시하기
    2. 초안 블로그 게시물 만들기
  6. 게시물 검색
    1. 모든 블로그 게시물 검색
    2. 쿼리 매개변수를 사용하여 게시물 검색
  7. 게시물 업데이트
  8. 게시물 삭제
  9. 설명
    1. 댓글 작성
    2. 댓글 가져오기
    3. 댓글 삭제

대상

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

이 문서에서는 사용자가 Google Data API 프로토콜에 관한 일반적인 개념을 이해하고 있다고 가정합니다.

클라이언트 라이브러리에서 제공하는 클래스 및 메서드에 대한 자세한 내용은 자바 클라이언트 라이브러리 API 참조를 확인하세요. 일반적인 Blogger Data API 참조 정보는 프로토콜 참조 가이드를 확인하세요.

시작하기

클라이언트 라이브러리 설정에 관한 도움말은 시작 가이드를 참고하세요.

자바 클라이언트 라이브러리에는 자바 1.5가 필요합니다. 클라이언트 라이브러리를 다운로드한 후 시작하는 데 필요한 클래스를 java/lib/gdataclient-1.0.jar 파일에서 확인할 수 있습니다.

Blogger 계정 만들기

테스트 목적으로 Blogger 계정에 가입하는 것이 좋습니다. Blogger는 Google 계정을 사용하므로 이미 Google 계정이 있다면 모든 준비가 완료된 것입니다.

샘플 코드 실행

이 문서에 나와 있는 모든 샘플 코드를 포함한, 제대로 작동하는 샘플 클라이언트는 자바 클라이언트 라이브러리 배포의 gdata/java/sample/blogger/BloggerClient.java 디렉터리에 있습니다. 빌드 및 실행 안내는 README.txt 파일의 동일한 디렉터리에 포함됩니다.

샘플 클라이언트는 제공된 블로그에서 여러 작업을 수행하여 Blogger Data API의 사용을 보여줍니다.

이 문서의 예를 자체 코드로 컴파일하려면 다음 import 문이 필요합니다.

import com.google.gdata.client.*;
import com.google.gdata.data.*;
import com.google.gdata.util.*;
import java.io.IOException;
import java.net.URL;

Blogger 서비스 인증

Blogger Data API를 사용하여 공개 및 비공개 피드에 모두 액세스할 수 있습니다. 공개 피드는 인증이 필요하지 않지만 읽기 전용입니다. 블로그를 수정하려면 클라이언트에서 비공개 피드를 요청하기 전에 인증해야 합니다. AuthSub 프록시 인증 또는 ClientLogin 사용자 이름/비밀번호 인증 중 하나를 사용하여 인증할 수 있습니다.

일반적인 Google Data API 인증에 대한 자세한 내용은 인증 문서를 참조하세요.

이 문서의 후속 섹션에 나오는 대부분의 샘플은 인증된 GoogleService 객체가 있다고 가정합니다.

AuthSub 프록시 인증

AuthSub 프록시 인증은 Google 계정에 대해 사용자를 인증해야 하는 웹 애플리케이션에서 사용합니다. 웹사이트 운영자와 클라이언트 코드는 Blogger 사용자의 사용자 이름과 비밀번호에 대한 액세스 권한이 없습니다. 그 대신 클라이언트가 특정 사용자 대신 작업할 수 있는 특별한 AuthSub 토큰을 얻습니다. 자세한 내용은 AuthSub 문서를 참조하세요.

사용자가 애플리케이션을 처음 방문했을 때는 아직 인증되지 않았습니다. 이 경우 블로그에 대한 액세스 요청을 인증하기 위해 사용자를 Google 페이지로 안내하는 몇 가지 정보와 링크를 표시해야 합니다. 자바 클라이언트 라이브러리는 Google 페이지 URL을 생성하는 함수를 제공합니다. 아래 코드는 AuthSubRequest 페이지의 URL을 검색합니다.

String next = "http://www.example.com/welcome.html";
String scope = "http://www.blogger.com/feeds/";
boolean secure = false;
boolean session = true;
String authSubLogin = AuthSubUtil.getRequestUrl(next, scope, secure, session);

getRequestUrl 메서드는 AuthSubRequest 핸들러에서 사용하는 쿼리 매개변수에 해당하는 다음 매개변수를 사용합니다.

다음
인증 후 Google이 사용자를 리디렉션해야 하는 페이지의 URL입니다.
범위
애플리케이션에서 Blogger 피드에 액세스하기 위해 토큰을 요청함을 나타냅니다. 사용할 범위 문자열은 http://www.blogger.com/feeds/입니다(물론 URL 인코딩됨).
보안
클라이언트가 보안 토큰을 요청하는지 여부를 나타냅니다.
session
반환된 토큰을 다용도 (세션) 토큰으로 교환할 수 있는지를 나타냅니다.

위의 예시는 보안 토큰을 요청하지 않는 호출 (secure 값 false)을 보여줍니다. 결과 URL은 다음과 같을 수 있습니다.

https://www.google.com/accounts/AuthSubRequest?scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F&session=1&secure=0&next=http%3A%2F%2Fwww.example.com%2Fwelcome.html

사용자가 Google 사이트 링크를 따라 Google 계정으로 인증합니다.

사용자가 인증되면 AuthSub 시스템은 AuthSubRequest URL의 next 쿼리 매개변수에 지정한 URL로 사용자를 리디렉션합니다. AuthSub 시스템은 해당 URL에 인증 토큰을 token 쿼리 매개변수의 값으로 추가합니다. 예를 들면 다음과 같습니다.

http://www.example.com/welcome.html?token=yourAuthToken

이 토큰 값은 일회용 AuthSub 토큰을 나타냅니다. 이 예시에서는 session = true가 지정되었으므로 다음과 같이 AuthSubSessionToken 서비스를 호출하여 이 토큰을 AuthSub 세션 토큰으로 교환할 수 있습니다. 여기서 urlFromAuthSub는 AuthSub가 토큰을 추가한 URL입니다.

String token = AuthSubUtil.getTokenFromReply(urlFromAuthSub);
String sessionToken = AuthSubUtil.exchangeForSessionToken(token, null);

즉, 일회용 토큰을 null(등록되지 않은 모드의 경우) 또는 비공개 키 (등록된 모드의 경우)와 함께 exchangeForSessionToken 메서드에 전달하면 AuthSub 인터페이스가 세션 토큰을 반환합니다. 등록된 애플리케이션 및 비공개 키에 대한 자세한 내용은 AuthSub 문서의 '요청 서명' 섹션을 참조하세요.

그런 다음 애플리케이션은 이후의 Blogger 상호작용에서 세션 토큰을 사용할 수 있습니다. 각 요청에 세션 토큰을 자동으로 전송하도록 자바 클라이언트 라이브러리에 알리려면 GoogleService 객체의 setAuthSubToken 메서드를 호출합니다.

GoogleService.setAuthSubToken(sessionToken, null);

이후 클라이언트 라이브러리는 모든 요청과 함께 토큰을 자동으로 전송합니다.

ClientLogin 사용자 이름/비밀번호 인증

클라이언트가 독립형 사용자 설치 클라이언트 (예: 데스크톱 애플리케이션)인 경우 ClientLogin 인증을 사용합니다. GoogleService 객체에서 setUserCredentials 메서드를 호출하기만 하면 Blogger와의 모든 후속 상호작용이 인증됩니다.

GoogleService myService = new GoogleService("blogger", "exampleCo-exampleApp-1");
myService.setUserCredentials("user@example.com", "secretPassword");

위 스니펫에서는 매개변수 두 개를 GoogleService 생성자에 전달합니다. 첫 번째 매개변수는 상호작용하려는 서비스의 이름입니다. 두 번째 매개변수는 애플리케이션의 이름입니다(companyName-applicationName-versionID 형식).

샘플 요청 및 응답을 포함하여 ClientLogin 인증에 대한 자세한 내용은 설치된 애플리케이션의 인증 문서를 참고하세요.

참고: 특정 세션의 모든 요청에 동일한 토큰을 사용합니다. 각 Blogger 요청에 대해 새 토큰을 획득하지 마세요.

참고: ClientLogin 문서에 설명된 대로 인증 요청이 실패하고 보안문자 본인 확인이 요청될 수 있습니다. Google에서 보안문자 질문을 발급하고 처리하도록 하려면 ClientLogin 문서에 제공된 보안문자 처리 URL이 아닌 https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger로 사용자를 보냅니다.

블로그 목록 가져오기

Blogger Data API는 특정 사용자의 블로그를 나열하는 피드를 제공합니다. 이 피드는 "metafeed."

다음 샘플 코드는 인증된 GoogleService 객체를 사용하여 메타피드를 검색한 다음 각 블로그의 제목을 출력합니다.

public static void printUserBlogs(GoogleService myService)
    throws ServiceException, IOException {

  // Request the feed
  final URL feedUrl = new URL("http://www.blogger.com/feeds/default/blogs");
  Feed resultFeed = myService.getFeed(feedUrl, Feed.class);

  // Print the results
  System.out.println(resultFeed.getTitle().getPlainText());
  for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    Entry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
  }
}

getFeed 메서드에서 사용하는 URL을 확인하세요. 기본 메타피드 URL로, 현재 인증된 사용자의 블로그 목록을 반환합니다. 다른 사용자의 피드에 액세스하려면 메타피드 URL에서 default 대신 사용자의 ID를 입력하면 됩니다. 사용자 ID는 사용자 프로필 URL의 끝에 있는 숫자 문자열입니다.

게시물 작성

Blogger Data API를 사용하면 항목 초안을 작성하는 것은 물론 새 블로그 항목을 만들고 게시할 수 있습니다.

참고: 게시물의 맞춤 작성자 설정은 현재 지원되지 않습니다. 모든 새 게시물은 현재 인증된 사용자가 만든 것처럼 표시됩니다.

블로그 게시물 게시하기

자바 클라이언트 라이브러리를 사용하여 새 블로그 항목을 게시할 수 있습니다.

먼저 블로그 게시물을 나타내는 Entry 객체를 만듭니다. 그런 다음 블로그 게시물의 제목, 콘텐츠 및 기타 속성을 설정할 수 있습니다. 마지막으로 GoogleService 객체를 사용하여 게시물을 삽입합니다. 다음은 새로운 블로그 게시물을 게시하는 방법의 예입니다.

public static Entry createPost(
    GoogleService myService, String blogID, String title,
    String content, String userName)
    throws ServiceException, IOException {
  // Create the entry to insert
  Entry myEntry = new Entry();
  myEntry.setTitle(new PlainTextConstruct(title));
  myEntry.setContent(new PlainTextConstruct(content));

  // Ask the service to insert the new entry
  URL postUrl = new URL("http://www.blogger.com/feeds/" + blogID + "/posts/default");
  return myService.insert(postUrl, myEntry);
}

insert 메서드는 서비스의 게시물 URL을 매개변수로 사용합니다. 그런 다음 이 메서드는 Blogger에 저장된 항목을 반환합니다. 반환된 항목은 보낸 항목과 동일하지만 Blogger에서 추가한 다양한 요소(예: 게시물 ID)도 포함됩니다.

어떤 이유로든 요청이 실패하면 Blogger에서 다른 상태 코드를 반환할 수 있습니다. 상태 코드에 대한 자세한 내용은 Google Data API 프로토콜 참조 문서를 확인하세요.

블로그 게시물 초안 작성

초안 게시물은 공개 게시물과 동일한 방식으로 생성되지만 Entry 객체의 draft 속성을 설정해야 합니다. 강조표시된 줄을 추가하여 위와 같이 블로그 게시물을 초안으로 만들 수 있습니다.

public static Entry createPost(GoogleService myService, String blogId,
    String title, String content, String userName,
    Boolean isDraft)
    throws ServiceException, IOException {
  // Create the entry to insert
  Entry myEntry = new Entry();
  myEntry.setTitle(new PlainTextConstruct(title));
  myEntry.setContent(new PlainTextConstruct(content));
  myEntry.setDraft(isDraft);

  // Ask the service to insert the new entry
  URL postUrl = new URL("http://www.blogger.com/feeds/" + blogID + "/posts/default");
  return myService.insert(postUrl, myEntry);
}

기존 초안 블로그 게시물을 초안 게시물을 검색하고 초안 속성을 false로 설정한 후 글을 업데이트하여 게시된 글로 전환할 수 있습니다. 다음 두 섹션에서 게시물 검색 및 업데이트를 살펴보겠습니다.

게시물을 가져오는 중

다음 섹션에서는 쿼리 매개변수를 사용하거나 사용하지 않고 블로그 게시물 목록을 검색하는 방법을 설명합니다.

인증 없이 Blogger 공개 피드를 쿼리할 수 있습니다. 따라서 공개 블로그에서 게시물을 가져오기 전에 setUserCredentials 메서드를 호출하거나 AuthSub 인증을 할 필요가 없습니다.

모든 블로그 게시물 검색

사용자의 게시물을 가져오려면 블로그 메타피드를 검색하는 데 사용한 것과 동일한 getFeed 메서드를 호출하되 이번에는 블로그 게시물 피드 URL을 전송합니다.

public static void printAllPosts(
    GoogleService myService, String blogId)
    throws ServiceException, IOException {
  // Request the feed
  URL feedUrl = new URL("http://www.blogger.com/feeds/" + blogID + "/posts/default");
  Feed resultFeed = myService.getFeed(feedUrl, Feed.class);

  // Print the results
  System.out.println(resultFeed.getTitle().getPlainText());
  for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    Entry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
  }
  System.out.println();
}

쿼리 매개변수를 사용하여 게시물 검색

Blogger Data API를 사용하면 지정된 기간 동안 게시 또는 업데이트된 블로그 게시물을 요청하는 등 지정된 기준과 일치하는 항목 집합을 요청할 수 있습니다. 이렇게 하려면 Query 객체를 만들어 GoogleService.getQuery 메서드에 전달합니다.

예를 들어 기간 쿼리를 보내려면 Query 객체의 setPublishedMin 및 setPublishedMax 메서드를 사용합니다. 다음 코드 스니펫은 지정된 시작 시간과 종료 시간 사이에 게시된 각 블로그 게시물의 제목을 출력합니다.

public static void printDateRangeQueryResults(
    GoogleService myService, String blogId,
    DateTime startTime, DateTime endTime)
    throws ServiceException, IOException {
  // Create query and submit a request
  URL feedUrl = new URL("http://www.blogger.com/feeds/" + blogID + "/posts/default");
  Query myQuery = new Query(feedUrl);
  myQuery.setPublishedMin(startTime);
  myQuery.setPublishedMax(endTime);
  Feed resultFeed = myService.query(myQuery, Feed.class);

  // Print the results
  System.out.println(resultFeed.getTitle().getPlainText() +
      " posts between " + startTime + " and " + endTime);
  for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    Entry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
    System.out.println("\t" + entry.getUpdated().toStringRfc822());
  }
  System.out.println();
}

Query 객체는 게시물을 검색하는 데 사용되는 것과 동일한 게시물 피드 URL을 사용하여 구성됩니다.

Blogger Data API는 다음 Query 메서드를 지원합니다.

카테고리 추가
피드 결과를 필터링하려면 카테고리 (라벨이라고도 함)를 지정하세요. 예를 들어 http://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurie는 라벨이 Fritz 및 Laurie인 항목을 반환합니다.
setMaxResults
반환할 최대 항목 수를 설정합니다.
setPublishMin, setPublishMax
항목 게시 날짜의 경계를 설정합니다.
setStartIndex
검색할 첫 번째 결과의 1 기반 색인을 설정합니다 (페이징).
setUpdatedMin, setUpdatedMax
항목 업데이트 날짜의 경계를 설정합니다. orderby 매개변수가 updated로 설정되어 있지 않으면 이러한 쿼리 매개변수는 무시됩니다.

참고: 현재 orderby 쿼리 매개변수에 setter가 없습니다. 그러나 이를 설정해야 하는 경우에는 Query.addCustomParameter() 메서드를 사용하면 됩니다.

쿼리 매개변수에 대한 자세한 내용은 Blogger Data API 참조 가이드 및 Google Data API 참조 가이드를 확인하세요.

게시물 업데이트

기존 블로그 게시물을 업데이트하려면 먼저 업데이트할 항목을 검색하고 수정한 다음 update 메서드를 사용하여 Blogger로 보냅니다. 다음 코드 스니펫은 사용자가 이미 서버에서 항목을 검색했다고 가정하고 블로그 항목의 제목을 수정합니다.

public static Entry updatePostTitle(
    GoogleService myService, Entry entryToUpdate, String newTitle)
    throws ServiceException, IOException {
  entryToUpdate.setTitle(new PlainTextConstruct(newTitle));
  URL editUrl = new URL(entryToUpdate.getEditLink().getHref());
  return myService.update(editUrl, entryToUpdate);
}

위의 코드는 전체 업데이트된 새 게시물을 포함하는 Entry를 반환합니다. 다른 속성을 업데이트하려면 update를 호출하기 전에 Entry 객체에서 설정하면 됩니다.

참고: 게시물과 연결된 작성자 데이터를 수정하는 기능은 현재 지원되지 않습니다.

게시물 삭제

게시물을 삭제하려면 다음과 같이 게시물의 수정 URL을 GoogleService 객체의 delete 메서드에 전달합니다.

public static void deletePost(
    GoogleService myService, String editLinkHref)
    throws ServiceException, IOException {
  URL deleteUrl = new URL(editLinkHref);
  myService.delete(deleteUrl);
}

주석

Blogger Data API를 사용하면 댓글을 작성, 검색, 삭제할 수 있습니다. 주석 업데이트는 지원되지 않으며 웹 인터페이스에서도 사용할 수 없습니다.

댓글 작성

주석을 게시하려면 Entry 객체를 만들고 다음과 같이 삽입합니다.

public static Entry createComment(
    GoogleService myService, String blogID, String postId,
    String commentText)
    throws ServiceException, IOException {
  // Build the comment feed URI
  String commentsFeedUri = "http://www.blogger.com/feeds/" + blogID + "/" + postId + "/comments/default";
  URL feedUrl = new URL(commentsFeedUri);

  // Create a new entry for the comment and submit it to the GoogleService
  Entry myEntry = new Entry();
  myEntry.setContent(new PlainTextConstruct(commentText));
  return myService.insert(feedUrl, myEntry);
}

참고: 현재 인증된 사용자가 소유한 블로그에만 댓글을 게시할 수 있습니다.

참고: 현재 댓글에 맞춤 작성자를 설정하는 기능은 지원되지 않습니다. 모든 새 주석은 현재 인증된 사용자가 작성한 것처럼 표시됩니다.

댓글을 가져오는 중

게시물의 댓글 피드 URL에서 특정 게시물의 댓글을 검색할 수 있습니다.

public static void printAllComments(
    GoogleService myService, String blogID, String postId)
    throws ServiceException, IOException {
  // Build comment feed URI and request comments on the specified post
  String commentsFeedUri = "http://www.blogger.com/feeds/" + blogID + "/" + postId + "/comments/default";
  URL feedUrl = new URL(commentsFeedUri);
  Feed resultFeed = myService.getFeed(feedUrl, Feed.class);

  // Display the results
  System.out.println(resultFeed.getTitle().getPlainText());
  for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    Entry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" +
        ((TextContent) entry.getContent()).getContent().getPlainText());
    System.out.println("\t" + entry.getUpdated().toStringRfc822());
  }
  System.out.println();
}

또는 블로그 댓글 피드 URL을 사용하여 모든 글의 댓글을 가져올 수 있습니다.

http://www.blogger.com/feeds/blogID/comments/default

댓글 삭제

주석을 삭제하려면 다음과 같이 댓글의 수정 URL을 GoogleService 객체의 delete 메서드에 전달합니다.

public static void deleteComment(GoogleService myService, String editLinkHref)
    throws ServiceException, IOException {
  URL deleteUrl = new URL(editLinkHref);
  myService.delete(deleteUrl);
}

맨 위로