#!/usr/bin/python

###

#

# Retrieves YouTube Analytics report data. The script's default behavior

# is to retrieve data for the authenticated user's channel. However, if you

# set a value for the --content-owner command-line argument, then the script

# retrieves data for that content owner. Note that the user running the script

# must be authorized to retrieve data for that content owner.

#

# Note that when you retrieve Analytics data for a content owner, your API

# request must set a value for the "filters" request parameter as explained

# in the API documentation here:

# https://developers.google.com/youtube/analytics/v1/content_owner_reports#Filters

#

# By default, if you set a value for the --content-owner argument, then the

# "filters" parameter is set to "claimedStatus==claimed". (On the other hand,

# this value is not set if you are retrieving data for your own channel.)

#

# You can use the --filters command-line argument to set the "filters" parameter

# for any request. For example:

# * --filters="channel==CHANNEL_ID"

# * --filters="channel==CHANNEL_ID;country==COUNTRY_CODE"

# * --filters="video==VIDEO_ID"

# " --filters="claimedStatus==claimed;uploaderType==thirdParty"

# and so forth.

#

###

import argparse

import os

import google.oauth2.credentials

import google_auth_oauthlib.flow

from googleapiclient.discovery import build

from googleapiclient.errors import HttpError

from google_auth_oauthlib.flow import InstalledAppFlow

from datetime import datetime, timedelta

# The CLIENT_SECRETS_FILE variable specifies the name of a file that contains

# the OAuth 2.0 information for this application, including its client_id and

# client_secret. You can acquire an OAuth 2.0 client ID and client secret from

# the {{ Google Cloud Console }} at

# {{ https://cloud.google.com/console }}.

# Please ensure that you have enabled the YouTube Analytics API for your project.

# For more information about using OAuth2 to access the YouTube Analytics API, see:

# https://developers.google.com/youtube/reporting/guides/authorization

# For more information about the client_secret.json file format, see:

# https://developers.google.com/api-client-library/python/guide/aaa_client_secrets

CLIENT_SECRETS_FILE = 'client_secret.json'

# These OAuth 2.0 access scopes allow for read-only access to the authenticated

# user's account for both YouTube Data API resources and YouTube Analytics Data.

SCOPES = ['https://www.googleapis.com/auth/yt-analytics.readonly']

API_SERVICE_NAME = 'youtubeAnalytics'

API_VERSION = 'v1'

# Authorize the request and store authorization credentials.

def get_authenticated_service():

return api_service

# Remove keyword arguments that are not set.

def remove_empty_args(args):

return good_args

# Set the "ids" request parameter for the YouTube Analytics API request.

def set_ids_parameter(args):

return args

def run_analytics_report(youtube_analytics, args):

print

if __name__ == '__main__':

now = datetime.now()

one_day_ago = (now - timedelta(days=1)).strftime('%Y-%m-%d')

one_week_ago = (now - timedelta(days=7)).strftime('%Y-%m-%d')

parser = argparse.ArgumentParser()

# Set channel ID or content owner. Default is authenticated user's channel.

parser.add_argument('--channel-id', default='',

help='YouTube channel ID for which data should be retrieved. ' +

'Note that the default behavior is to retrieve data for ' +

'the authenticated user\'s channel.')

parser.add_argument('--content-owner', default='',

help='The name of the content owner for which data should be ' +

'retrieved. If you retrieve data for a content owner, then ' +

'your API request must also set a value for the "filters" ' +

'parameter. See the help for that parameter for more details.')

# Metrics, dimensions, filters

parser.add_argument('--metrics', help='Report metrics',

default='views,estimatedMinutesWatched,averageViewDuration')

parser.add_argument('--dimensions', help='Report dimensions', default='')

parser.add_argument('--filters', default='',

help='Filters for the report. Note that the filters request parameter ' +

'must be set in YouTube Analytics API requests for content owner ' +

'reports. The script sets "filters=claimedStatus==claimed" if a ' +

'content owner is specified and filters are not specified.')

# Report dates. Defaults to start 7 days ago, end yesterday.

parser.add_argument('--start-date', default=one_week_ago,

help='Start date, in YYYY-MM-DD format')

parser.add_argument('--end-date', default=one_day_ago,

help='End date, in YYYY-MM-DD format')

parser.add_argument('--max-results', help='Max results')

parser.add_argument('--sort', help='Sort order', default='')

args = parser.parse_args()

args = set_ids_parameter(args)

youtube_analytics = get_authenticated_service()

try:

run_analytics_report(youtube_analytics, args)

except HttpError, e:

print 'An HTTP error %d occurred:\n%s' % (e.resp.status, e.content)