#!/usr/bin/python # -*- coding: utf-8 -*- # # Copyright 2014 Google Inc. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """Simple intro to using the Google Analytics API v3. This application demonstrates how to use the python client library to access Google Analytics data. The sample traverses the Management API to obtain the authorized user's first profile ID. Then the sample uses this ID to contstruct a Core Reporting API query to return the top 25 organic search terms. Before you begin, you must sigup for a new project in the Google APIs console: https://code.google.com/apis/console Then register the project to use OAuth2.0 for installed applications. Finally you will need to add the client id, client secret, and redirect URL into the client_secrets.json file that is in the same directory as this sample. Sample Usage: $ python hello_analytics_api_v3.py Also you can also get help on all the command-line flags the program understands by running: $ python hello_analytics_api_v3.py --help """ from __future__ import print_function __author__ = 'api.nickm@gmail.com (Nick Mihailovski)' import argparse import sys import csv from googleapiclient.errors import HttpError from googleapiclient import sample_tools from oauth2client.client import AccessTokenRefreshError def main(argv): # Authenticate and construct service. service, flags = sample_tools.init( argv, 'analytics', 'v3', __doc__, __file__, scope='https://www.googleapis.com/auth/analytics.readonly') # Try to make a request to the API. Print the results or handle errors. try: first_profile_id = '12345789' # Hard Code View Profile ID Here if not first_profile_id: print('Could not find a valid profile for this user.') else: results = get_top_keywords(service, first_profile_id) print_results(results) except TypeError as error: # Handle errors in constructing a query. print(('There was an error in constructing your query : %s' % error)) except HttpError as error: # Handle API errors. print(('Arg, there was an API error : %s : %s' % (error.resp.status, error._get_reason()))) except AccessTokenRefreshError: # Handle Auth errors. print ('The credentials have been revoked or expired, please re-run ' 'the application to re-authorize') def get_first_profile_id(service): """Traverses Management API to return the first profile id. This first queries the Accounts collection to get the first account ID. This ID is used to query the Webproperties collection to retrieve the first webproperty ID. And both account and webproperty IDs are used to query the Profile collection to get the first profile id. Args: service: The service object built by the Google API Python client library. Returns: A string with the first profile ID. None if a user does not have any accounts, webproperties, or profiles. """ accounts = service.management().accounts().list().execute() if accounts.get('items'): firstAccountId = accounts.get('items')[0].get('id') webproperties = service.management().webproperties().list( accountId=firstAccountId).execute() if webproperties.get('items'): firstWebpropertyId = webproperties.get('items')[0].get('id') profiles = service.management().profiles().list( accountId=firstAccountId, webPropertyId=firstWebpropertyId).execute() if profiles.get('items'): return profiles.get('items')[0].get('id') return None def get_top_keywords(service, profile_id): """Executes and returns data from the Core Reporting API. This queries the API for the top 25 organic search terms by visits. Args: service: The service object built by the Google API Python client library. profile_id: String The profile ID from which to retrieve analytics data. Returns: The response returned from the Core Reporting API. """ return service.data().ga().get( ids='ga:' + profile_id, start_date='30daysAgo', end_date='yesterday', metrics='ga:sessions', dimensions='ga:date').execute() def print_results(results): """Prints out the results. This prints out the profile name, the column headers, and all the rows of data. Args: results: The response returned from the Core Reporting API. """ print() print('Profile Name: %s' % results.get('profileInfo').get('profileName')) print() # Open a file. filepath = 'C:\\path\\to\\file\\' #change this to your actual file path filename = 'gapythondata.csv' #change this to your actual file name f = open(filepath.strip('\\') + '\\' + filename, 'wt') # Wrap file with a csv.writer writer = csv.writer(f, lineterminator='\n') # Write header. header = [h['name'][3:] for h in results.get('columnHeaders')] #this takes the column headers and gets rid of ga: prefix writer.writerow(header) print(''.join('%30s' %h for h in header)) # Write data table. if results.get('rows', []): for row in results.get('rows'): writer.writerow(row) print(''.join('%30s' %r for r in row)) print('\n') print ('Success Data Written to CSV File') print ('filepath = ' + filepath) print ('filename = '+ filename) else: print ('No Rows Found') # Close the file. f.close() if __name__ == '__main__': main(sys.argv)