このページは Cloud Translation API によって翻訳されました。

API クイックスタート

このページでは、お好みで Google アナリティクス Data API v1 の使用を開始する方法について説明しますクライアントライブラリを使用してプログラミング言語を学習できます。

ステップ 1. API を有効にする

次のボタンをクリックすると、新しい Google Cloud プロジェクトが自動的に作成されます Google Analytics Data API v1 を有効にして、このチュートリアルに必要なサービスアカウントを作成します。

表示されたダイアログで、[クライアント構成をダウンロード] をクリックして、ファイルを保存します。 credentials.json で作業ディレクトリに移動します。

ステップ 2. Google アナリティクスのプロパティにサービスアカウントを追加する

テキストエディタを使用して、ダウンロードした credentials.json ファイルを開きます。 client_email フィールドを検索してなどのサービスアカウントのメールアドレスに "quickstart@PROJECT-ID.iam.gserviceaccount.com".

このメールアドレスを使用して、ユーザーを Google Google Analytics Data API v1 を使用してアクセスするアナリティクスプロパティを指定します。このチュートリアルでは閲覧者権限のみ必要があります。

ステップ 3. 認証を構成する

このアプリケーションでは、サービス API を使用した Google アナリティクス Data API v1 の口座認証情報。

詳細: サービスアカウント認証情報を作成して設定するための手順は、説明します。

サービスアカウントの認証情報を指定する方法の一つは、サービスアカウントの GOOGLE_APPLICATION_CREDENTIALS 環境変数 API クライアントはこの変数の値を使用して、サービスアカウントを検索する必要があります。

この例でアプリケーションの認証情報を設定するには、次のコマンドを実行します。ステップ 1 でダウンロードしたサービスアカウント JSON ファイルのパスを使用します。

 export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

例:

 export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/credentials.json"

ステップ 4. クライアントライブラリをインストールする

Go

go get google.golang.org/genproto/googleapis/analytics/data/v1beta

API 呼び出しを行う

Google Analytics Data API を使って Google アナリティクスのデータをプロパティです。次のコードを実行して、API への最初の呼び出しを行います。

Java

<ph type="x-smartling-placeholder"></ph> google-analytics-data/src/main/java/com/google/analytics/data/samples/QuickstartSample.java

<ph type="x-smartling-placeholder"></ph> Cloud Shell で開くをご覧ください。 GitHub で表示

import com.google.analytics.data.v1beta.BetaAnalyticsDataClient;
import com.google.analytics.data.v1beta.DateRange;
import com.google.analytics.data.v1beta.Dimension;
import com.google.analytics.data.v1beta.Metric;
import com.google.analytics.data.v1beta.Row;
import com.google.analytics.data.v1beta.RunReportRequest;
import com.google.analytics.data.v1beta.RunReportResponse;

/**
 * Google Analytics Data API sample quickstart application.
 *
 * <p>This application demonstrates the usage of the Analytics Data API using service account
 * credentials.
 *
 * <p>Before you start the application, please review the comments starting with "TODO(developer)"
 * and update the code to use correct values.
 *
 * <p>To run this sample using Maven:
 *
 * <pre>{@code
 * cd google-analytics-data
 * mvn compile exec:java -Dexec.mainClass="com.google.analytics.data.samples.QuickstartSample"
 * }</pre>
 */
public class QuickstartSample {

  public static void main(String... args) throws Exception {
    /**
     * TODO(developer): Replace this variable with your Google Analytics 4 property ID before
     * running the sample.
     */
    String propertyId = "YOUR-GA4-PROPERTY-ID";
    sampleRunReport(propertyId);
  }

  // This is an example snippet that calls the Google Analytics Data API and runs a simple report
  // on the provided GA4 property id.
  static void sampleRunReport(String propertyId) throws Exception {
    // Using a default constructor instructs the client to use the credentials
    // specified in GOOGLE_APPLICATION_CREDENTIALS environment variable.
    try (BetaAnalyticsDataClient analyticsData = BetaAnalyticsDataClient.create()) {

      RunReportRequest request =
          RunReportRequest.newBuilder()
              .setProperty("properties/" + propertyId)
              .addDimensions(Dimension.newBuilder().setName("city"))
              .addMetrics(Metric.newBuilder().setName("activeUsers"))
              .addDateRanges(DateRange.newBuilder().setStartDate("2020-03-31").setEndDate("today"))
              .build();

      // Make the request.
      RunReportResponse response = analyticsData.runReport(request);

      System.out.println("Report result:");
      // Iterate through every row of the API response.
      for (Row row : response.getRowsList()) {
        System.out.printf(
            "%s, %s%n", row.getDimensionValues(0).getValue(), row.getMetricValues(0).getValue());
      }
    }
  }
}QuickstartSample.java

Python

<ph type="x-smartling-placeholder"></ph> google-analytics-data/quickstart.py

<ph type="x-smartling-placeholder"></ph> Cloud Shell で開くをご覧ください。 GitHub で表示

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import (
    DateRange,
    Dimension,
    Metric,
    RunReportRequest,
)


def sample_run_report(property_id="YOUR-GA4-PROPERTY-ID"):
    """Runs a simple report on a Google Analytics 4 property."""
    # TODO(developer): Uncomment this variable and replace with your
    #  Google Analytics 4 property ID before running the sample.
    # property_id = "YOUR-GA4-PROPERTY-ID"

    # Using a default constructor instructs the client to use the credentials
    # specified in GOOGLE_APPLICATION_CREDENTIALS environment variable.
    client = BetaAnalyticsDataClient()

    request = RunReportRequest(
        property=f"properties/{property_id}",
        dimensions=[Dimension(name="city")],
        metrics=[Metric(name="activeUsers")],
        date_ranges=[DateRange(start_date="2020-03-31", end_date="today")],
    )
    response = client.run_report(request)

    print("Report result:")
    for row in response.rows:
        print(row.dimension_values[0].value, row.metric_values[0].value)

quickstart.py

Node.js

<ph type="x-smartling-placeholder"></ph> google-analytics-data/quickstart.js

<ph type="x-smartling-placeholder"></ph> Cloud Shell で開くをご覧ください。 GitHub で表示

  /**
   * TODO(developer): Uncomment this variable and replace with your
   *   Google Analytics 4 property ID before running the sample.
   */
  // propertyId = 'YOUR-GA4-PROPERTY-ID';

  // Imports the Google Analytics Data API client library.
  const {BetaAnalyticsDataClient} = require('@google-analytics/data');

  // Using a default constructor instructs the client to use the credentials
  // specified in GOOGLE_APPLICATION_CREDENTIALS environment variable.
  const analyticsDataClient = new BetaAnalyticsDataClient();

  // Runs a simple report.
  async function runReport() {
    const [response] = await analyticsDataClient.runReport({
      property: `properties/${propertyId}`,
      dateRanges: [
        {
          startDate: '2020-03-31',
          endDate: 'today',
        },
      ],
      dimensions: [
        {
          name: 'city',
        },
      ],
      metrics: [
        {
          name: 'activeUsers',
        },
      ],
    });

    console.log('Report result:');
    response.rows.forEach((row) => {
      console.log(row.dimensionValues[0], row.metricValues[0]);
    });
  }

  runReport();quickstart.js

.NET

analytics-data/QuickStart/QuickStart.cs

<ph type="x-smartling-placeholder"></ph> Cloud Shell で開くをご覧ください。 GitHub で表示

using Google.Analytics.Data.V1Beta;
using System;

namespace AnalyticsSamples
{
    class QuickStart
    {
        static void SampleRunReport(string propertyId="YOUR-GA4-PROPERTY-ID")
        {
            /**
             * TODO(developer): Uncomment this variable and replace with your
             *  Google Analytics 4 property ID before running the sample.
             */
            // propertyId = "YOUR-GA4-PROPERTY-ID";

            // Using a default constructor instructs the client to use the credentials
            // specified in GOOGLE_APPLICATION_CREDENTIALS environment variable.
            BetaAnalyticsDataClient client = BetaAnalyticsDataClient.Create();

            // Initialize request argument(s)
            RunReportRequest request = new RunReportRequest
            {
                Property = "properties/" + propertyId,
                Dimensions = { new Dimension{ Name="city"}, },
                Metrics = { new Metric{ Name="activeUsers"}, },
                DateRanges = { new DateRange{ StartDate="2020-03-31", EndDate="today"}, },
            };

            // Make the request
            RunReportResponse response = client.RunReport(request);

            Console.WriteLine("Report result:");
            foreach(Row row in response.Rows)
            {
                Console.WriteLine("{0}, {1}", row.DimensionValues[0].Value, row.MetricValues[0].Value);
            }
        }
        static int Main(string[] args)
        {
            if (args.Length > 0) {
                SampleRunReport(args[0]);
            } else {
                SampleRunReport();
            }
            return 0;
        }
    }
}QuickStart.cs

PHP

<ph type="x-smartling-placeholder"></ph> google-analytics-data/quickstart.php

<ph type="x-smartling-placeholder"></ph> Cloud Shell で開くをご覧ください。 GitHub で表示

require 'vendor/autoload.php';

use Google\Analytics\Data\V1beta\Client\BetaAnalyticsDataClient;
use Google\Analytics\Data\V1beta\DateRange;
use Google\Analytics\Data\V1beta\Dimension;
use Google\Analytics\Data\V1beta\Metric;
use Google\Analytics\Data\V1beta\RunReportRequest;

/**
 * TODO(developer): Replace this variable with your Google Analytics 4
 *   property ID before running the sample.
 */
$property_id = 'YOUR-GA4-PROPERTY-ID';

// Using a default constructor instructs the client to use the credentials
// specified in GOOGLE_APPLICATION_CREDENTIALS environment variable.
$client = new BetaAnalyticsDataClient();

// Make an API call.
$request = (new RunReportRequest())
    ->setProperty('properties/' . $property_id)
    ->setDateRanges([
        new DateRange([
            'start_date' => '2020-03-31',
            'end_date' => 'today',
        ]),
    ])
    ->setDimensions([new Dimension([
            'name' => 'city',
        ]),
    ])
    ->setMetrics([new Metric([
            'name' => 'activeUsers',
        ])
    ]);
$response = $client->runReport($request);

// Print results of an API call.
print 'Report result: ' . PHP_EOL;

foreach ($response->getRows() as $row) {
    print $row->getDimensionValues()[0]->getValue()
        . ' ' . $row->getMetricValues()[0]->getValue() . PHP_EOL;
}quickstart.php

API クイックスタート

ステップ 1. API を有効にする

ステップ 2. Google アナリティクスのプロパティにサービス アカウントを追加する

ステップ 3. 認証を構成する

ステップ 4. クライアント ライブラリをインストールする

Java

Python

Node.js

.NET

PHP

Go

API 呼び出しを行う

Java

Python

Node.js

.NET

PHP

ステップ 2. Google アナリティクスのプロパティにサービスアカウントを追加する

ステップ 4. クライアントライブラリをインストールする