Krótkie wprowadzenie do interfejsu API przy użyciu wiersza poleceń

Z tej strony dowiesz się, jak rozpocząć korzystanie z interfejsu Google Analytics Data API w wersji 1 za pomocą polecenia .

Krok 1. Włącz API

Kliknij przycisk, aby automatycznie utworzyć nowy projekt Google Cloud włącz interfejs Google Analytics Data API v1 i utwórz dane uwierzytelniające OAuth2 potrzebne do tego celu, samouczek:

Włączanie interfejsu Google Analytics Data API w wersji 1

Nastąpi automatyczne przekierowanie do konfiguracji danych logowania OAuth2 . Gdy pojawi się pytanie Skąd dzwonisz?, wybierz Komputer

W wyświetlonym oknie kliknij POBIERZ KONFIGURACJĘ KLIENTA i zapisz plik. credentials.json do katalogu roboczego.

Możesz też wykonać te kroki, aby utworzyć OAuth2 Dane uwierzytelniające w istniejącym możesz tworzyć projekty ręcznie.

Krok 2. Zainstaluj i zainicjuj pakiet SDK Cloud

Potrzebny jest wiersz poleceń gcloud. zainstalowane na komputerze, na którym pracujesz.

Krok 3. Wywołaj interfejs API

Teraz można używać interfejsu Google Analytics Data API do wysyłania zapytań dotyczących Google Analytics. usłudze.

Wybierz podmiot zgłaszający

W tym samouczku użyjemy zmiennej środowiskowej GA_PROPERTY_ID do przechowywania Identyfikator usługi, który ma być używany w żądaniach do interfejsu API.

Aby ustawić zmienną GA_PROPERTY_ID, w wierszu poleceń wpisz:

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

Zastąp [YOUR_GA_PROPERTY_ID] swoją usługą w Google Analytics Na przykład:

export GA_PROPERTY_ID=1234567890

Tworzenie pliku JSON żądania

W pliku request.json znajdziesz informacje o tym, jak utworzyć prosty raport.

Utwórz plik żądania JSON o następującym tekście i zapisz go jako Plik tekstowy request.json w katalogu roboczym:

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

Uwierzytelnij

Aby w tym przykładzie uzyskać dane logowania użytkownika, uruchom poniższe polecenie i użyj polecenia ścieżkę do pliku JSON z danymi logowania pobranego w kroku 1:

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

W nowym oknie przeglądarki otworzy się okno z prośbą o zgodę użytkownika OAuth.

Wysyłanie żądania

Użyj polecenia curl i treści z pliku request.json, aby wysłać żądanie do interfejsu API danych Google Analytics. W wierszu poleceń wpisz:

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA_PROPERTY_ID:runReport -d @request.json

Polecenie curl używa gcloud auth application-default print-access-token aby uzyskać token uwierzytelniania.

Pamiętaj, że aby przekazać nazwę pliku do zwijania, należy użyć opcji -d (w przypadku „danych”) oraz poprzedź nazwę pliku znakiem @. Ten plik powinien znajdować się w tym samym katalogu w którym wykonujesz polecenie „curl”.