Witamy w interfejsie Analytics Reporting API w wersji 4. Krótkie wprowadzenie do zainstalowanych aplikacji w języku Java

W tym samouczku opisujemy, jak uzyskać dostęp do interfejsu Analytics Reporting API w wersji 4.

1. Włącz API

Aby zacząć korzystać z interfejsu Analytics Reporting API w wersji 4, musisz najpierw użyć narzędzia do konfiguracji, które przeprowadzi Cię przez proces tworzenia projektu w Konsoli interfejsów API Google, włączania interfejsu API i tworzenia danych logowania.

Uwaga: aby utworzyć identyfikator klienta internetowego lub klienta zainstalowanej aplikacji, musisz ustawić nazwę usługi na ekranie zgody. Pojawi się prośba o skonfigurowanie ekranu zgody (jeśli nie zostało to jeszcze zrobione).

Utwórz dane logowania

  • Otwórz stronę Dane logowania.
  • Kliknij Utwórz dane logowania i wybierz Identyfikator klienta OAuth.
  • W polu Typ aplikacji wybierz Inny.
  • Nadaj identyfikatorowi klienta quickstart i kliknij Create (Utwórz).

Na stronie Dane logowania kliknij nowo utworzony identyfikator klienta, a następnie kliknij Pobierz JSON i zapisz go jako client_secrets.json. Będzie on potrzebny w dalszej części samouczka.

2. Instalowanie biblioteki klienta

Aby zainstalować klienta Java interfejsu Google Analytics API, musisz pobrać plik zip zawierający wszystkie pliki jar, które musisz wyodrębnić i skopiować do ścieżki klasy Java.

  1. Pobierz bibliotekę klienta Java interfejsu Analytics Reporting API w wersji 4, która jest dołączona jako plik ZIP ze wszystkimi wymaganymi zależnościami.
  2. Rozpakuj plik ZIP.
  3. Dodaj do ścieżki zajęć wszystkie pliki JAR z katalogu libs.
  4. Dodaj do ścieżki klasy plik jar google-api-services-analyticsreporting-v4-[version].jar.

Szczegóły środowiska Java

Zaćmienie

W przypadku Eclipse zapoznaj się z tym pytaniem StackOverflow, aby dowiedzieć się, jak dodać pliki JAR do ścieżki klasy projektu.

NetBeans

W przypadku NetBeans zapoznaj się z tym pytaniem w StackOverflow, aby dowiedzieć się, jak dodać pliki JAR do ścieżki klasy projektu.

IDEA IntelliJ

W przypadku pomysłów IntelliJ zapoznaj się z tym pytaniem na stronie StackOverflow, aby dowiedzieć się, jak dodać pliki JAR do ścieżki klasy projektu.

Wiersz poleceń

Jeśli programujesz z użyciem wiersza poleceń, dodaj do wywołań poleceń javac i java te dane:

-classpath /path/to/directory/with/unzipped/jars

3. Skonfiguruj przykład

Musisz utworzyć jeden plik o nazwie HelloAnalyticsReporting.java, który będzie zawierał podany przykładowy kod.

  • Skopiuj lub pobierz ten kod źródłowy do usługi HelloAnalyticsReporting.java.
  • Przenieś wcześniej pobrany plik client_secrets.json do tego samego katalogu co przykładowy kod.
  • Zastąp wartość VIEW_ID identyfikatorem widoku, do którego chcesz uzyskać dostęp.
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 java.io.File;
import java.io.IOException;
import java.io.InputStreamReader;
import java.security.GeneralSecurityException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import com.google.analyticsreporting.v4.AnalyticsreportingScopes;
import com.google.analyticsreporting.v4.Analyticsreporting;
import com.google.analyticsreporting.v4.model.ColumnHeader;
import com.google.analyticsreporting.v4.model.DateRange;
import com.google.analyticsreporting.v4.model.DateRangeValues;
import com.google.analyticsreporting.v4.model.Dimension;
import com.google.analyticsreporting.v4.model.GetReportsRequest;
import com.google.analyticsreporting.v4.model.GetReportsResponse;
import com.google.analyticsreporting.v4.model.Metric;
import com.google.analyticsreporting.v4.model.MetricHeaderEntry;
import com.google.analyticsreporting.v4.model.Report;
import com.google.analyticsreporting.v4.model.ReportRequest;
import com.google.analyticsreporting.v4.model.ReportRow;


/**
 * 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";

  // Replace with your view ID.
  private static final String VIEW_ID = "<REPLACE_WITH_VIEW_ID>";

  // 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 Reporting";
  private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
  private static NetHttpTransport httpTransport;
  private static FileDataStoreFactory dataStoreFactory;

  public static void main(String[] args) {
    try {
      Analyticsreporting service = initializeAnalyticsReporting();

      GetReportsResponse response = getReport(service);
      printResponse(response);
    } catch (Exception e) {
      e.printStackTrace();
    }
  }


  /**
   * Initializes an authorized Analytics Reporting service object.
   *
   * @return The analytics reporting service object.
   * @throws IOException
   * @throws GeneralSecurityException
   */
  private static Analyticsreporting initializeAnalyticsReporting() throws GeneralSecurityException, IOException {

    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 authorization scopes.
    GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow
        .Builder(httpTransport, JSON_FACTORY, clientSecrets,
            AnalyticsreportingScopes.all()).setDataStoreFactory(dataStoreFactory)
        .build();

    // Authorize.
    Credential credential = new AuthorizationCodeInstalledApp(flow,
        new LocalServerReceiver()).authorize("user");
    // Construct the Analytics Reporting service object.
    return new Analyticsreporting.Builder(httpTransport, JSON_FACTORY, credential)
        .setApplicationName(APPLICATION_NAME).build();
  }

  /**
   * Query the Analytics Reporting API V4.
   * Constructs a request for the sessions for the past seven days.
   * Returns the API response.
   *
   * @param service
   * @return GetReportResponse
   * @throws IOException
   */
  private static GetReportsResponse getReport(Analyticsreporting service) throws IOException {
    // Create the DateRange object.
    DateRange dateRange = new DateRange();
    dateRange.setStartDate("7DaysAgo");
    dateRange.setEndDate("today");

    // Create the Metrics object.
    Metric sessions = new Metric()
        .setExpression("ga:sessions")
        .setAlias("sessions");

    //Create the Dimensions object.
    Dimension browser = new Dimension()
        .setName("ga:browser");

    // Create the ReportRequest object.
    ReportRequest request = new ReportRequest()
        .setViewId(VIEW_ID)
        .setDateRanges(Arrays.asList(dateRange))
        .setDimensions(Arrays.asList(browser))
        .setMetrics(Arrays.asList(sessions));

    ArrayList<ReportRequest> requests = new ArrayList<ReportRequest>();
    requests.add(request);

    // Create the GetReportsRequest object.
    GetReportsRequest getReport = new GetReportsRequest()
        .setReportRequests(requests);

    // Call the batchGet method.
    GetReportsResponse response = service.reports().batchGet(getReport).execute();

    // Return the response.
    return response;
  }

  /**
   * Parses and prints the Analytics Reporting API V4 response.
   *
   * @param response the Analytics Reporting API V4 response.
   */
  private static void printResponse(GetReportsResponse response) {

    for (Report report: response.getReports()) {
      ColumnHeader header = report.getColumnHeader();
      List<String> dimensionHeaders = header.getDimensions();
      List<MetricHeaderEntry> metricHeaders = header.getMetricHeader().getMetricHeaderEntries();
      List<ReportRow> rows = report.getData().getRows();

      if (rows == null) {
         System.out.println("No data found for " + VIEW_ID);
         return;
      }

      for (ReportRow row: rows) {
        List<String> dimensions = row.getDimensions();
        List<DateRangeValues> metrics = row.getMetrics();
        for (int i = 0; i < dimensionHeaders.size() && i < dimensions.size(); i++) {
          System.out.println(dimensionHeaders.get(i) + ": " + dimensions.get(i));
        }

        for (int j = 0; j < metrics.size(); j++) {
          System.out.print("Date Range (" + j + "): ");
          DateRangeValues values = metrics.get(j);
          for (int k = 0; k < values.getValues().size() && k < metricHeaders.size(); k++) {
            System.out.println(metricHeaders.get(k).getName() + ": " + values.getValues().get(k));
          }
        }
      }
    }
  }
}

4. Uruchamianie przykładu

Jeśli używasz IDE, sprawdź, czy masz domyślne środowisko docelowe ustawione na klasę HelloAnalytics.

  • Aplikacja wczyta stronę autoryzacji w przeglądarce.
  • Jeśli użytkownik nie jest zalogowany na konto Google, pojawi się prośba o zalogowanie. Jeśli korzystasz z kilku kont Google, pojawi się prośba o wybranie jednego z nich do autoryzacji.

Po zakończeniu tych czynności w przykładzie zostanie wyświetlona liczba sesji dla danego widoku danych w ciągu ostatnich 7 dni.