В этом руководстве описаны шаги, необходимые для доступа к API отчетов Google Analytics версии 4.
1. Включите API
Чтобы начать использовать Analytics Reporting API v4, вам необходимо сначала использовать инструмент настройки , который поможет вам создать проект в консоли Google API, включить API и создать учетные данные.
Создать учетные данные
- Откройте страницу учетных записей службы . При появлении запроса выберите проект.
- Нажмите учетную запись службы» , введите имя и описание учетной записи службы. Вы можете использовать идентификатор учетной записи службы по умолчанию или выбрать другой, уникальный. Когда закончите, нажмите «Создать» .
- Следующий раздел «Разрешения учетной записи службы (необязательно)» не является обязательным. Нажмите Продолжить .
- На экране «Предоставить пользователям доступ к этой учетной записи службы» прокрутите вниз до раздела «Создать ключ» . Нажмите Создать ключ» .
- На появившейся боковой панели выберите формат вашего ключа: рекомендуется JSON .
- Нажмите Создать . Ваша новая пара открытого/закрытого ключей генерируется и загружается на ваш компьютер; он служит единственной копией этого ключа. Информацию о том, как безопасно хранить данные, см. в разделе Управление ключами сервисных учетных записей .
- Нажмите «Закрыть» в диалоговом окне «Закрытый ключ, сохраненный на вашем компьютере» , затем нажмите « Готово», чтобы вернуться к таблице ваших учетных записей служб.
Добавить сервисный аккаунт в аккаунт 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
, который будет содержать данный пример кода.
- Скопируйте или загрузите следующий исходный код в
HelloAnalytics.py
. - Переместите ранее загруженный
client_secrets.json
в тот же каталог, что и пример кода. - Замените значение
KEY_FILE_LOCATION
соответствующим путем к загруженномуclient_secrets.json
. - Замените значение
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
, заменив<pip_install_path>
со значением, определенным выше:экспорт PYTHONPATH=$PYTHONPATH:<pip_install_path>
Перезагрузите файл
~/.bashrc
во всех открытых окнах терминала, используя следующую команду:источник ~/.bashrc