Быстрый запуск API с использованием командной строки

На этой странице показано, как начать работу с API данных Google Analytics v1 с помощью командной строки.

Шаг 1. Включите API

Нажмите эту кнопку, чтобы создать новый проект облачной платформы, автоматически включить Google Analytics Data API v1 и создать учетные данные OAuth2, необходимые для этого руководства:

Включите API данных Google Analytics v1.

Вы будете автоматически перенаправлены в диалоговое окно настройки учетных данных OAuth2. На вопрос «Откуда вы звоните?» выберите «Рабочий стол».

В появившемся диалоговом окне нажмите «СКАЧАТЬ КОНФИГУРАЦИЯ КЛИЕНТА» и сохраните файл credentials.json в своем рабочем каталоге.

Кроме того, вы можете выполнить следующие действия, чтобы создать учетные данные OAuth2 в существующем проекте вручную.

Шаг 2. Установите и инициализируйте Cloud SDK.

Вам понадобится инструмент командной строки gcloud , установленный на вашем компьютере разработки.

Шаг 3. Сделайте вызов API

Теперь вы можете использовать API данных Google Analytics для запроса ресурса Google Analytics 4.

Выберите отчитывающуюся организацию

В этом руководстве мы будем использовать переменную среды GA4_PROPERTY_ID для хранения идентификатора свойства, который будет использоваться в запросах API.

Введите следующее в командной строке, чтобы установить переменную GA4_PROPERTY_ID :

export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]

Замените [YOUR-GA4-PROPERTY-ID] идентификатором своего ресурса Google Analytics 4 . Например:

export GA4_PROPERTY_ID=1234567890

Создайте запрос в формате JSON

Следующий файл request.json демонстрирует, как создать простой отчет.

Создайте файл запроса JSON со следующим текстом и сохраните его как обычный текстовый файл request.json в своем рабочем каталоге:

request.json

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

Аутентификация

Чтобы получить учетные данные пользователя в этом примере, выполните следующую команду и используйте путь к JSON-файлу учетных данных, загруженному на шаге 1:

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

Диалоговое окно согласия пользователя OAuth откроется в новом окне браузера.

Отправить запрос

Используйте curl и содержимое тела из request.json , чтобы отправить запрос в API данных Google Analytics. Введите следующее в командной строке:

  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/$GA4_PROPERTY_ID:runReport -d @request.json

Команда curl использует команду gcloud auth application-default print-access-token для получения токена аутентификации.

Обратите внимание, что для передачи имени файла в Curl вы используете опцию -d (для «данных») и ставите перед именем файла знак @. Этот файл должен находиться в том же каталоге, в котором вы выполняете команду Curl.

Поздравляем! Вы отправили свой первый запрос в API данных Google Analytics.