W tym samouczku opisujemy krok po kroku, 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. Zobaczysz prośbę o skonfigurowanie ekranu akceptacji.Utwórz dane logowania
- Otwórz stronę Dane logowania.
- Kliknij Utwórz dane logowania i wybierz Identyfikator klienta OAuth.
- Jako Typ aplikacji wybierz Aplikacja internetowa.
- Nadaj identyfikatorowi klienta quickstart, a następnie kliknij Create (Utwórz).
- Ustaw Autoryzowane źródła JavaScript na
http://localhost:8080
- Kliknij Utwórz.
2. Konfigurowanie przykładu
Musisz utworzyć jeden plik o nazwie HelloAnalytics.html
, który będzie zawierał kod HTML i JavaScript użyty w naszym przykładzie.
- Skopiuj lub pobierz ten kod źródłowy do
HelloAnalytics.html
. - Zastąp
<REPLACE_WITH_CLIENT_ID>
identyfikatorem klienta utworzonym powyżej. - Zastąp
<REPLACE_WITH_VIEW_ID>
identyfikatorem widoku. Identyfikator widoku można pobrać z Eksploratora kont.
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Hello Analytics Reporting API V4</title> <meta name="google-signin-client_id" content="<REPLACE_WITH_CLIENT_ID>"> <meta name="google-signin-scope" content="https://www.googleapis.com/auth/analytics.readonly"> </head> <body> <h1>Hello Analytics Reporting API V4</h1> <!-- The Sign-in button. This will run `queryReports()` on success. --> <p class="g-signin2" data-onsuccess="queryReports"></p> <!-- The API response will be printed here. --> <textarea cols="80" rows="20" id="query-output"></textarea> <script> // Replace with your view ID. var VIEW_ID = '<REPLACE_WITH_VIEW_ID>'; // Query the API and print the results to the page. function queryReports() { gapi.client.request({ path: '/v4/reports:batchGet', root: 'https://analyticsreporting.googleapis.com/', method: 'POST', body: { reportRequests: [ { viewId: VIEW_ID, dateRanges: [ { startDate: '7daysAgo', endDate: 'today' } ], metrics: [ { expression: 'ga:sessions' } ] } ] } }).then(displayResults, console.error.bind(console)); } function displayResults(response) { var formattedJson = JSON.stringify(response.result, null, 2); document.getElementById('query-output').value = formattedJson; } </script> <!-- Load the JavaScript API client and Sign-in library. --> <script src="https://apis.google.com/js/client:platform.js"></script> </body> </html>
3. Uruchamianie przykładu
- Opublikuj
HelloAnalytics.html
na swoim serwerze WWW i załaduj stronę w przeglądarce. - Kliknij przycisk Zaloguj się i autoryzuj dostęp do Google Analytics.
Gdy wykonasz te czynności, w przykładzie wyświetli się liczba sesji dla danego widoku danych z ostatnich 7 dni.