Hello Analytics API: 설치된 애플리케이션을 위한 자바 빠른 시작

이 튜토리얼에서는 Google 애널리틱스 계정 액세스, 애널리틱스 API 쿼리, API 응답 처리, 결과 출력에 필요한 단계를 설명합니다. 이 튜토리얼에서는 Core Reporting API v3.0, Management API v3.0, OAuth2.0이 사용됩니다.

참고: 이 빠른 시작 가이드의 목적은 Google API 클라이언트 라이브러리를 사용하여 API 승인의 초기 문제를 해결하는 데 도움이 됩니다. 이러한 라이브러리는 개발 중이므로 경우에 따라 최신 클라이언트 라이브러리와 동기화되지 않을 수 있습니다. 이 문제가 발생하면 클라이언트 라이브러리 문서를 확인하고 필요한 경우 도움말 문서를 참조하세요.

1단계: 애널리틱스 API 사용 설정

Google 애널리틱스 API를 사용하려면 먼저 설정 도구를 사용해야 합니다. 이 가이드에서는 Google API 콘솔에서 프로젝트 만들기, API 사용 설정, 사용자 인증 정보 생성 과정을 안내합니다.

웹 클라이언트 ID 또는 설치된 애플리케이션 클라이언트를 만들려면 동의 화면에서 제품 이름을 설정해야 합니다. 아직 구성하지 않았다면 동의 화면 구성하라는 메시지가 표시됩니다.

클라이언트 ID 만들기

사용자 인증 정보 페이지에서 다음을 수행합니다.

1. 사용자 인증 정보 만들기를 클릭하고 OAuth 클라이언트 ID를 선택합니다.
2. 애플리케이션 유형에서 기타를 선택합니다.
3. 사용자 인증 정보의 이름을 지정합니다.
4. 만들기를 클릭합니다.

방금 만든 사용자 인증 정보를 선택하고 JSON 다운로드를 클릭합니다. 다운로드한 파일은 client_secrets.json로 저장합니다. 이 튜토리얼의 뒷부분이 필요합니다.

2단계: Google 클라이언트 라이브러리 설치

Google 애널리틱스 API 자바 클라이언트를 설치하려면 자바 클래스 경로에 추출하고 복사해야 하는 모든 jar가 포함된 ZIP 파일을 다운로드해야 합니다.

1. 필요한 모든 종속 항목이 포함된 ZIP 파일로 번들로 제공되는 Google 애널리틱스 자바 클라이언트 라이브러리를 다운로드합니다.
2. ZIP 파일 추출
3. libs 디렉터리 내의 모든 JAR을 클래스 경로에 추가합니다.
4. 클래스 경로에 google-api-services-analytics-v3-[version].jar jar을 추가합니다.

...자바 환경 세부정보 자세히 알아보기

자바 환경 세부정보

Eclipse를 사용 중인 경우 프로젝트의 클래스 경로에 JAR을 추가하는 방법은 여기에서 확인하세요.

NetBeans를 사용 중인 경우 프로젝트의 클래스 경로에 JAR을 추가하는 방법은 여기에서 확인하세요.

IntelliJ IDEA를 사용하는 경우 여기에서 프로젝트의 클래스 경로에 JAR을 추가하는 방법을 참조하세요.

명령줄에서 개발하는 경우 javac 및 java 명령어 호출에 -classpath /path/to/directory/with/unzipped/jars를 추가합니다.

참고: 자바 런타임 환경에 따라 javax.webserver.jar를 다운로드하여 프로젝트의 클래스 경로에 추가해야 할 수도 있습니다.

3단계: 샘플 설정

주어진 샘플 코드가 포함된 HelloAnalytics.java이라는 단일 파일을 만들어야 합니다.

1. 다음 소스 코드를 복사하거나 HelloAnalytics.java에 다운로드합니다.
2. 이전에 다운로드한 client_secrets.json을 샘플 코드와 같은 디렉터리 내에서 이동합니다.

import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.client.util.store.FileDataStoreFactory;
import com.google.api.services.analytics.Analytics;
import com.google.api.services.analytics.AnalyticsScopes;
import com.google.api.services.analytics.model.Accounts;
import com.google.api.services.analytics.model.GaData;
import com.google.api.services.analytics.model.Profiles;
import com.google.api.services.analytics.model.Webproperties;

import java.io.File;
import java.io.IOException;
import java.io.InputStreamReader;


/**
 * A simple example of how to access the Google Analytics API.
 */
public class HelloAnalytics {
  // Path to client_secrets.json file downloaded from the Developer's Console.
  // The path is relative to HelloAnalytics.java.
  private static final String CLIENT_SECRET_JSON_RESOURCE = "client_secrets.json";

  // The directory where the user's credentials will be stored.
  private static final File DATA_STORE_DIR = new File(
      System.getProperty("user.home"), ".store/hello_analytics");

  private static final String APPLICATION_NAME = "Hello Analytics";
  private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
  private static NetHttpTransport httpTransport;
  private static FileDataStoreFactory dataStoreFactory;

  public static void main(String[] args) {
    try {
      Analytics analytics = initializeAnalytics();
      String profile = getFirstProfileId(analytics);
      printResults(getResults(analytics, profile));
    } catch (Exception e) {
      e.printStackTrace();
    }
  }

  private static Analytics initializeAnalytics() throws Exception {

    httpTransport = GoogleNetHttpTransport.newTrustedTransport();
    dataStoreFactory = new FileDataStoreFactory(DATA_STORE_DIR);

    // Load client secrets.
    GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(JSON_FACTORY,
        new InputStreamReader(HelloAnalytics.class
            .getResourceAsStream(CLIENT_SECRET_JSON_RESOURCE)));

    // Set up authorization code flow for all auth scopes.
    GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow
        .Builder(httpTransport, JSON_FACTORY, clientSecrets,
        AnalyticsScopes.all()).setDataStoreFactory(dataStoreFactory)
        .build();

    // Authorize.
    Credential credential = new AuthorizationCodeInstalledApp(flow,
        new LocalServerReceiver()).authorize("user");

    // Construct the Analytics service object.
    return new Analytics.Builder(httpTransport, JSON_FACTORY, credential)
        .setApplicationName(APPLICATION_NAME).build();
  }

  private static String getFirstProfileId(Analytics analytics) throws IOException {
    // Get the first view (profile) ID for the authorized user.
    String profileId = null;

    // Query for the list of all accounts associated with the service account.
    Accounts accounts = analytics.management().accounts().list().execute();

    if (accounts.getItems().isEmpty()) {
      System.err.println("No accounts found");
    } else {
      String firstAccountId = accounts.getItems().get(0).getId();

      // Query for the list of properties associated with the first account.
      Webproperties properties = analytics.management().webproperties()
          .list(firstAccountId).execute();

      if (properties.getItems().isEmpty()) {
        System.err.println("No properties found");
      } else {
        String firstWebpropertyId = properties.getItems().get(0).getId();

        // Query for the list views (profiles) associated with the property.
        Profiles profiles = analytics.management().profiles()
            .list(firstAccountId, firstWebpropertyId).execute();

        if (profiles.getItems().isEmpty()) {
          System.err.println("No views (profiles) found");
        } else {
          // Return the first (view) profile associated with the property.
          profileId = profiles.getItems().get(0).getId();
        }
      }
    }
    return profileId;
  }

  private static GaData getResults(Analytics analytics, String profileId) throws IOException {
    // Query the Core Reporting API for the number of sessions
    // in the past seven days.
    return analytics.data().ga()
        .get("ga:" + profileId, "7daysAgo", "today", "ga:sessions")
        .execute();
  }

  private static void printResults(GaData results) {
    // Parse the response from the Core Reporting API for
    // the profile name and number of sessions.
    if (results != null && !results.getRows().isEmpty()) {
      System.out.println("View (Profile) Name: "
        + results.getProfileInfo().getProfileName());
      System.out.println("Total Sessions: " + results.getRows().get(0).get(0));
    } else {
      System.out.println("No results found");
    }
  }
}

4단계: 샘플 실행

애널리틱스 API를 사용 설정한 후 자바용 Google API 클라이언트 라이브러리를 설치하고 샘플을 실행할 준비가 된 샘플 소스 코드를 설정합니다.

IDE를 사용하는 경우 기본 실행 대상이 HelloAnalytics 클래스로 설정되어 있는지 확인하세요.

1. 애플리케이션이 브라우저에서 승인 페이지를 로드합니다.
2. 아직 Google 계정에 로그인하지 않은 경우 로그인하라는 메시지가 표시됩니다. 여러 Google 계정에 로그인한 경우 승인에 사용할 계정을 하나 선택하라는 메시지가 표시됩니다.

이 단계를 완료하면 샘플에서는 승인된 사용자의 첫 번째 Google 애널리틱스 보기 (프로필)의 이름과 지난 7일 동안의 세션 수를 출력합니다.

참고: 이 샘플을 성공적으로 실행하려면 하나 이상의 Google 애널리틱스 속성 및 보기(프로필)가 있어야 합니다.

이제 승인된 애널리틱스 서비스 객체를 사용하면 Management API 참조 문서에 있는 코드 샘플을 실행할 수 있습니다. 예를 들어 accountSummaries.list 메서드를 사용하도록 코드를 변경할 수 있습니다.