Upgrade google api python client

Введение в Google Analytics API: краткое руководство по Python для установленных приложений

В этом руководстве описывается, как получить доступ к аккаунту Google Analytics, отправлять запросы в API этого сервиса, обрабатывать ответы и извлекать результаты обработки с применением Core Reporting API 3.0, Management API 3.0 и OAuth 2.0.

Примечание. Цель этих кратких руководств – помочь пользователю выполнить авторизацию API с помощью клиентских библиотек API Google. Поскольку эти библиотеки постоянно обновляются, информации о последних изменениях здесь может не быть. Если вы не нашли нужные сведения, ознакомьтесь с документацией по клиентским библиотекам и справочной информацией.

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

Перед началом работы с Google Analytics API используйте инструмент настройки, чтобы создать проект в Google API Console, включить API и зарегистрировать учетные данные.

Чтобы создать идентификатор веб-клиента или клиента установленного приложения, нужно указать название продукта в окне запроса доступа. Если вы ещё не указали название, вам будет предложено это сделать.

Создайте идентификатор клиента

Откройте раздел «Учетные данные» и выполните следующие действия:

1. Нажмите Создать учетные данные и выберите Идентификатор клиента OAuth.
2. В разделе Тип приложения выберите Другие типы.
3. Введите название.
4. Нажмите кнопку Создать.

Выберите созданные учетные данные и нажмите Скачать файл JSON. Сохраните файл как client_secrets.json . Он понадобится вам позже.

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

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

pip

Рекомендуется использовать pip, специальный инструмент для установки пакетов Python:

sudo pip install --upgrade google-api-python-client

Setuptools

Можно также использовать инструмент easy_install, входящий в пакет setuptools:

sudo easy_install --upgrade google-api-python-client

Установка вручную

Загрузите последнюю клиентскую библиотеку для Python, распакуйте код и выполните его:

sudo python setup.py install

Возможно, вам придется вызвать команду с помощью прав администратора ( sudo ), чтобы установить Python в систему.

Шаг 3. Настройте пример

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

1. Скопируйте или скачайте приведенный ниже исходный код для HelloAnalytics.py .
2. Переместите ранее загруженный файл client_secrets.json в директорию, содержащую код образца.

"""A simple example of how to access the Google Analytics API.""" import argparse from apiclient.discovery import build import httplib2 from oauth2client import client from oauth2client import file from oauth2client import tools def get_service(api_name, api_version, scope, client_secrets_path): """Get a service that communicates to a Google API. Args: api_name: string The name of the api to connect to. api_version: string The api version to connect to. scope: A list of strings representing the auth scopes to authorize for the connection. client_secrets_path: string A path to a valid client secrets file. Returns: A service that is connected to the specified API. """ # Parse command-line arguments. parser = argparse.ArgumentParser( formatter_class=argparse.RawDescriptionHelpFormatter, parents=[tools.argparser]) flags = parser.parse_args([]) # Set up a Flow object to be used if we need to authenticate. flow = client.flow_from_clientsecrets( client_secrets_path, scope=scope, message=tools.message_if_missing(client_secrets_path)) # Prepare credentials, and authorize HTTP object with them. # If the credentials don't exist or are invalid run through the native client # flow. The Storage object will ensure that if successful the good # credentials will get written back to a file. storage = file.Storage(api_name + '.dat') credentials = storage.get() if credentials is None or credentials.invalid: credentials = tools.run_flow(flow, storage, flags) http = credentials.authorize(http=httplib2.Http()) # Build the service object. service = build(api_name, api_version, http=http) return service def get_first_profile_id(service): # Use the Analytics service object to get the first profile id. # Get a list of all Google Analytics accounts for the authorized user. accounts = service.management().accounts().list().execute() if accounts.get('items'): # Get the first Google Analytics account. account = accounts.get('items')[0].get('id') # Get a list of all the properties for the first account. properties = service.management().webproperties().list( accountId=account).execute() if properties.get('items'): # Get the first property id. property = properties.get('items')[0].get('id') # Get a list of all views (profiles) for the first property. profiles = service.management().profiles().list( accountId=account, webPropertyId=property).execute() if profiles.get('items'): # return the first view (profile) id. return profiles.get('items')[0].get('id') return None def get_results(service, profile_id): # Use the Analytics Service Object to query the Core Reporting API # for the number of sessions in the past seven days. return service.data().ga().get( ids='ga:' + profile_id, start_date='7daysAgo', end_date='today', metrics='ga:sessions').execute() def print_results(results): # Print data nicely for the user. if results: print 'View (Profile): %s' % results.get('profileInfo').get('profileName') print 'Total Sessions: %s' % results.get('rows')[0][0] else: print 'No results found' def main(): # Define the auth scopes to request. scope = ['https://www.googleapis.com/auth/analytics.readonly'] # Authenticate and construct service. service = get_service('analytics', 'v3', scope, 'client_secrets.json') profile = get_first_profile_id(service) print_results(get_results(service, profile)) if __name__ == '__main__': main()

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

После того как вы включили Google Analytics API, установили клиентскую библиотеку Google API для Python и настроили код примера, он готов к запуску.

Запустите образец, используя следующий код:

1. Приложение загрузит страницу авторизации в браузере.
2. Если вы ещё не вошли в аккаунт Google, вам будет предложено это сделать. Если вы вошли в несколько аккаунтов Google, вы должны будете выбрать для авторизации один из них.

После выполнения всех шагов образец выведет имя первого профиля авторизованного пользователя в Google Analytics и количество сеансов за последние семь дней.

Примечание. Для успешного запуска примера нужно иметь по крайней мере один ресурс и профиль Google Analytics.

Имея авторизованный служебный объект Analytics, вы можете запустить любой из примеров кода, приведенных в справочных материалах по Management API. Например, можно попробовать изменить код, чтобы использовать метод accountSummaries.list.

Устранение неполадок

AttributeError: ‘Module_six_moves_urllib_parse’ object has no attribute ‘urlparse’

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

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

pip show six | grep "Location:" | cut -d " " -f2 

export PYTHONPATH=$PYTHONPATH:

Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons «С указанием авторства 4.0», а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.

Последнее обновление: 2019-01-14 UTC.

Источник

Установка клиентских библиотек

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

Однако мы рекомендуем работать с клиентскими библиотеками API Google, поскольку они обеспечивают более высокий уровень безопасности, поддержку запросов, требующих авторизации, и более эффективную интеграцию языков. С клиентскими библиотеками вам больше не придется вручную настраивать HTTP-запросы и интерпретировать ответы.

Сначала выберите язык программирования, на котором вы пишете код.

Go

Java

На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Java. Более подробная информация приведена в следующей документации:

Как добавить клиентскую библиотеку в проект

Выберите среду сборки (Maven или Gradle).

Добавьте в файл pom.xml следующий код:

Посмотрите все доступные версии в центральном репозитории Maven.

Добавьте в файл build.gradle следующий код:

Посмотрите все доступные версии в центральном репозитории Maven.

JavaScript

Прочитайте руководство к этой библиотеке.

.NET

На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для .NET. Более подробная информация приведена в следующей документации:

Как скачать библиотеку

Установите пакет NuGet, доступный по этой ссылке: Google.Apis.

Node.js

Obj-C

PHP

Python

На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Python. Более подробная информация приведена в следующей документации:

Системные требования

Как установить клиентскую библиотеку

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

Установка с помощью менеджера пакетов

Для управления установкой используйте pip или setuptools. Возможно, сначала потребуется запустить sudo .

pip install --upgrade google-api-python-client

easy_install --upgrade google-api-python-client

Установка вручную

App Engine

Так как клиентские библиотеки для Python не установлены в среде выполнения Python сервиса App Engine, их необходимо скопировать в приложение тем же способом, что и другие сторонние библиотеки.

Ruby

На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Ruby. Более подробная информация приведена в следующей документации:

Как установить гем google-api-client

В некоторых системах перед этими командами нужно добавлять элемент sudo .

Если вы не устанавливали клиентскую библиотеку API Google для Ruby, сделайте это с помощью RubyGems :

gem install google-api-client

Если у вас уже установлен этот гем, обновите его до последней версии с помощью следующей команды:

gem update -y google-api-client

Как начать работу с клиентской библиотекой API Google для Ruby

Информацию о том, как создать первый запрос, можно найти в кратком руководстве по началу работы.

Другие способы обращения к Indexing API

Другие способы обращения к Indexing API приведены в следующей таблице:

Метод обращения	Описание
API Explorer	Интерактивный инструмент, позволяющий опробовать API Google прямо в браузере.

Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons «С указанием авторства 4.0», а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.

Последнее обновление: 2023-02-22 UTC.

Источник