API-Kurzanleitung

Auf dieser Seite erhalten Sie Informationen zu den ersten Schritten mit dem Google Analytics Data API v1 in Ihrem bevorzugten Programmiersprache mit den Clientbibliotheken.

Schritt 1: API aktivieren

Klicken Sie auf die folgende Schaltfläche, um automatisch ein neues Google Cloud-Projekt zu erstellen Aktivieren Sie die Google Analytics Data API v1 und erstellen Sie das für diese Anleitung erforderliche Dienstkonto:

Google Analytics Data API Version 1 aktivieren

Klicken Sie im daraufhin angezeigten Dialogfeld auf CLIENT-KONFIGURATION HERUNTERLADEN und speichern Sie die Datei. credentials.json in Ihr Arbeitsverzeichnis.

Schritt 2: Dienstkonto zur Google Analytics-Property hinzufügen

Öffnen Sie die heruntergeladene Datei credentials.json mit einem Texteditor. vorherigen Schritt und suchen Sie nach dem Feld client_email, um den Wert E-Mail-Adresse des Dienstkontos, z. B. "quickstart@PROJECT-ID.iam.gserviceaccount.com".

Verwenden Sie diese E-Mail-Adresse zum Hinzufügen eines Nutzer mit dem Google Analytics-Property, auf die Sie mit der Google Analytics Data API (Version 1) zugreifen möchten. In dieser Anleitung nur Viewer-Berechtigungen erforderlich sind.

Schritt 3: Authentifizierung konfigurieren

Diese Anwendung demonstriert die Verwendung des Google Analytics Data API Version 1 mithilfe von service Konto Anmeldedaten

Weitere Informationen für zum Erstellen und Festlegen von Dienstkonto-Anmeldedaten für Ihr .

Eine Möglichkeit, Anmeldedaten für ein Dienstkonto bereitzustellen, besteht darin, die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS Der API-Client verwendet den Wert dieser Variablen, um das Dienstkonto zu finden Schlüssel-JSON-Datei.

Führen Sie den folgenden Befehl aus, um die Anmeldedaten für die Anwendung in diesem Beispiel festzulegen. und verwenden Sie den Pfad zur JSON-Datei des Dienstkontos, die Sie in Schritt 1 heruntergeladen haben:

 export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Beispiel:

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

Schritt 4: Clientbibliothek installieren

API aufrufen

Jetzt können Sie das Google Analytics Data API verwenden, um eine Google Analytics- Property. Führen Sie den folgenden Code aus, um zum ersten Mal die API aufzurufen:

Java

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());
      }
    }
  }
}

Python

<ph type="x-smartling-placeholder"></ph> google-analytics-data/quickstart.py
<ph type="x-smartling-placeholder"></ph> In Cloud Shell öffnen Auf GitHub ansehen
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)


Node.js

<ph type="x-smartling-placeholder"></ph> google-analytics-data/quickstart.js
<ph type="x-smartling-placeholder"></ph> In Cloud Shell öffnen Auf GitHub ansehen
  /**
   * 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();

.NET

<ph type="x-smartling-placeholder"></ph> analytics-data/QuickStart/QuickStart.cs
<ph type="x-smartling-placeholder"></ph> In Cloud Shell öffnen Auf GitHub ansehen
using Google.Analytics.Data.V1Beta;
using System;

namespace AnalyticsSamples
{
    class QuickStart
    {
        static void SampleRunReport(string propertyId=YOUR-GA"4-PROPERTY-ID)
     "   {
            /**
             * TODO(developer): Uncomment this variable and replace with your
             *  Google Analytics 4 property ID before running the sample.
             */
            // propertyId = YOUR-GA4-PROP"ERTY-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/ + property"Id,
       "         Dimensions = { new Dimension{ Name=city}, },
             "   M"etrics = { new Metric{ Name=activeUsers}, },
       "         Da"teRanges = { new DateRange{ StartDate=2020-03-31, EndDate=today"}, },
    "        };"

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

            Console.WriteLine(Report result:);
            fo"reach(Row row "in response.Rows)
            {
                Console.WriteLine({0}, {1}, row.DimensionValues[0].V"alue, ro"w.MetricValues[0].Value);
            }
        }
        static int Main(string[] args)
        {
            SampleRunReport();
            return 0;
        }
    }
}
QuickStart.cs

PHP

<ph type="x-smartling-placeholder"></ph> google-analytics-data/quickstart.php
<ph type="x-smartling-placeholder"></ph> In Cloud Shell öffnen Auf GitHub ansehen
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;
}