API отчетов Hello Analytics v4; Краткое руководство по Python для сервисных учетных записей

В этом руководстве описаны шаги, необходимые для доступа к API отчетов Google Analytics версии 4.

1. Включите API

Чтобы начать использовать Analytics Reporting API v4, вам необходимо сначала использовать инструмент настройки , который поможет вам создать проект в консоли Google API, включить API и создать учетные данные.

Создать учетные данные

  1. Откройте страницу учетных записей службы . При появлении запроса выберите проект.
  2. Нажмите учетную запись службы» , введите имя и описание учетной записи службы. Вы можете использовать идентификатор учетной записи службы по умолчанию или выбрать другой, уникальный. Когда закончите, нажмите «Создать» .
  3. Следующий раздел «Разрешения учетной записи службы (необязательно)» не является обязательным. Нажмите Продолжить .
  4. На экране «Предоставить пользователям доступ к этой учетной записи службы» прокрутите вниз до раздела «Создать ключ» . Нажмите Создать ключ» .
  5. На появившейся боковой панели выберите формат вашего ключа: рекомендуется JSON .
  6. Нажмите Создать . Ваша новая пара открытого/закрытого ключей генерируется и загружается на ваш компьютер; он служит единственной копией этого ключа. Информацию о том, как безопасно хранить данные, см. в разделе Управление ключами сервисных учетных записей .
  7. Нажмите «Закрыть» в диалоговом окне «Закрытый ключ, сохраненный на вашем компьютере» , затем нажмите « Готово», чтобы вернуться к таблице ваших учетных записей служб.

Добавить сервисный аккаунт в аккаунт Google Analytics

Вновь созданная учетная запись службы будет иметь адрес электронной почты, похожий на:

quickstart@PROJECT-ID.iam.gserviceaccount.com

Используйте этот адрес электронной почты, чтобы добавить пользователя в представление Google Analytics, к которому вы хотите получить доступ через API. Для этого руководства необходимы только разрешения на чтение и анализ .

2. Установите клиентскую библиотеку.

Использование pip вместе с venv — рекомендуемый способ установки пакетов Python: sudo -s apt-get install python3-venv python3 -m venv Analytics-quickstart source Analytics-quickstart/bin/activate pip install --upgrade google-api-python- установка клиентского пункта --upgrade oauth2client

3. Настройте образец

Вам нужно будет создать один файл с именем HelloAnalytics.py , который будет содержать данный пример кода.

  1. Скопируйте или загрузите следующий исходный код в HelloAnalytics.py .
  2. Переместите ранее загруженный client_secrets.json в тот же каталог, что и пример кода.
  3. Замените значение KEY_FILE_LOCATION соответствующим путем к загруженному client_secrets.json .
  4. Замените значение VIEW_ID . Вы можете использовать проводник учетных записей , чтобы найти идентификатор представления.
"""Hello Analytics Reporting API V4."""

from apiclient.discovery import build
from oauth2client.service_account import ServiceAccountCredentials


SCOPES = ['https://www.googleapis.com/auth/analytics.readonly']
KEY_FILE_LOCATION = '<REPLACE_WITH_JSON_FILE>'
VIEW_ID = '<REPLACE_WITH_VIEW_ID>'


def initialize_analyticsreporting():
  """Initializes an Analytics Reporting API V4 service object.

  Returns:
    An authorized Analytics Reporting API V4 service object.
  """
  credentials = ServiceAccountCredentials.from_json_keyfile_name(
      KEY_FILE_LOCATION, SCOPES)

  # Build the service object.
  analytics = build('analyticsreporting', 'v4', credentials=credentials)

  return analytics


def get_report(analytics):
  """Queries the Analytics Reporting API V4.

  Args:
    analytics: An authorized Analytics Reporting API V4 service object.
  Returns:
    The Analytics Reporting API V4 response.
  """
  return analytics.reports().batchGet(
      body={
        'reportRequests': [
        {
          'viewId': VIEW_ID,
          'dateRanges': [{'startDate': '7daysAgo', 'endDate': 'today'}],
          'metrics': [{'expression': 'ga:sessions'}],
          'dimensions': [{'name': 'ga:country'}]
        }]
      }
  ).execute()


def print_response(response):
  """Parses and prints the Analytics Reporting API V4 response.

  Args:
    response: An Analytics Reporting API V4 response.
  """
  for report in response.get('reports', []):
    columnHeader = report.get('columnHeader', {})
    dimensionHeaders = columnHeader.get('dimensions', [])
    metricHeaders = columnHeader.get('metricHeader', {}).get('metricHeaderEntries', [])

    for row in report.get('data', {}).get('rows', []):
      dimensions = row.get('dimensions', [])
      dateRangeValues = row.get('metrics', [])

      for header, dimension in zip(dimensionHeaders, dimensions):
        print(header + ': ', dimension)

      for i, values in enumerate(dateRangeValues):
        print('Date range:', str(i))
        for metricHeader, value in zip(metricHeaders, values.get('values')):
          print(metricHeader.get('name') + ':', value)


def main():
  analytics = initialize_analyticsreporting()
  response = get_report(analytics)
  print_response(response)

if __name__ == '__main__':
  main()

4. Запустите образец

Запустите образец, используя:

python HelloAnalytics.py

Когда вы закончите эти шаги, в образце выводится количество сеансов за последние семь дней для данного представления.

Поиск неисправностей

AttributeError: объект «Module_six_moves_urllib_parse» не имеет атрибута «urlparse».

Эта ошибка может возникнуть в Mac OSX, где установка по умолчанию модуля «шесть» (зависимость этой библиотеки) загружается до того, который был установлен с помощью pip. Чтобы устранить эту проблему, добавьте место установки pip в системную переменную среды PYTHONPATH :

  • Определите место установки pip с помощью следующей команды:

    пип-шоу шесть | grep "Местоположение:" | вырезать -d " " -f2

  • Добавьте следующую строку в файл ~/.bashrc , заменив &lt;pip_install_path&gt; со значением, определенным выше:

    экспорт PYTHONPATH=$PYTHONPATH:<pip_install_path>

  • Перезагрузите файл ~/.bashrc во всех открытых окнах терминала, используя следующую команду:

    источник ~/.bashrc