-
Notifications
You must be signed in to change notification settings - Fork 3k
/
video_localizations.py
179 lines (150 loc) · 7.14 KB
/
video_localizations.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
#!/usr/bin/python
# Usage example:
# python video_localizations.py --action='<action>' --video_id='<video_id>' --default_language='<default_language>' --language='<language>' --title='<title>' --description='<description>'
import argparse
import os
import re
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
# 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 Data API for your project.
# For more information about using OAuth2 to access the YouTube Data API, see:
# https://developers.google.com/youtube/v3/guides/authentication
# For more information about the client_secrets.json file format, see:
# https://developers.google.com/api-client-library/python/guide/aaa_client_secrets
CLIENT_SECRETS_FILE = 'client_secret.json'
# This OAuth 2.0 access scope allows for full read/write access to the
# authenticated user's account.
SCOPES = ['https://www.googleapis.com/auth/youtube']
API_SERVICE_NAME = 'youtube'
API_VERSION = 'v3'
# Supported actions
ACTIONS = ('get', 'list', 'set')
# Authorize the request and store authorization credentials.
def get_authenticated_service():
flow = InstalledAppFlow.from_client_secrets_file(CLIENT_SECRETS_FILE, SCOPES)
credentials = flow.run_console()
return build(API_SERVICE_NAME, API_VERSION, credentials = credentials)
# Call the API's videos.update method to update an existing video's default language,
# localized title and description in a specific language.
def set_video_localization(youtube, args):
# Retrieve the snippet and localizations for the video.
results = youtube.videos().list(
part='snippet,localizations',
id=args.video_id
).execute()
video = results['items'][0]
# If the language argument is set, set the localized title and description
# for that language. The "title" and "description" arguments have default
# values to make the script simpler to run as a demo. In an actual app, you
# would likely want to set those arguments also.
if args.language and args.language != '':
if 'localizations' not in video:
video['localizations'] = {}
video['localizations'][args.language] = {
'title': args.title,
'description': args.description
}
# If the default language is set AND there is localized metadata for that
# language, set the video's title and description to match the localized
# title and description for the newly set default language.
if args.default_language and args.default_language in video['localizations']:
video['snippet']['defaultLanguage'] = args.default_language
video['snippet']['title'] = (
video['localizations'][args.default_language]['title'])
video['snippet']['description'] = (
video['localizations'][args.default_language]['description'])
# Update the video resource.
update_result = youtube.videos().update(
part='snippet,localizations',
body=video
).execute()
# Print the actions taken by running the script.
if args.language:
for language in update_result['localizations']:
# Languages with locales, like "pt-br" are returned as pt-BR in metadata.
# This ensures that the language specified when running the script can be
# matched to the language returned in the metadata.
if language.lower() == args.language.lower():
localization = update_result['localizations'][args.language]
print ('Updated video \'%s\' localized title to \'%s\''
' and description to \'%s\' in language \'%s\'' %
(args.video_id,
localization['title'],
localization['description'],
args.language))
break
if (args.default_language and
args.default_language == update_result['snippet']['defaultLanguage']):
print 'Updated default language to %s' % args.default_language
# Call the API's videos.list method to retrieve an existing video localization.
# If the localized text is not available in the requested language,
# this method returns text in the default language.
def get_video_localization(youtube, args):
results = youtube.videos().list(
part='snippet',
id=args.video_id,
hl=args.language
).execute()
# The localized object contains localized text if the hl parameter specified
# a language for which localized text is available. Otherwise, the localized
# object contains metadata in the default language.
localized = results['items'][0]['snippet']['localized']
print ('Video title is \'%s\' and description is \'%s\' in language \'%s\''
% (localized['title'], localized['description'], args.language))
# Call the API's videos.list method to list the existing video localizations.
def list_video_localizations(youtube, args):
results = youtube.videos().list(
part='snippet,localizations',
id=args.video_id
).execute()
if 'localizations' in results['items'][0]:
localizations = results['items'][0]['localizations']
for language, localization in localizations.iteritems():
print ('Video title is \'%s\' and description is \'%s\' in language \'%s\''
% (localization['title'], localization['description'], language))
else:
print 'There aren\'t any localizations for this video yet.'
if __name__ == '__main__':
parser = argparse.ArgumentParser()
# The action to be processed: 'get', 'list', and 'set' are supported.
parser.add_argument('--action', help='Action', choices=ACTIONS, required=True)
# The ID of the selected YouTube video.
parser.add_argument('--video_id',
help='The video ID for which localizations are being set or retrieved.',
required=True)
# The language of the video's default metadata.
parser.add_argument('--default_language',
help='Default language of the video to update.')
# The language of the localization that is being processed.
parser.add_argument('--language', help='Language of the localization.')
# The localized video title for the specified language.
parser.add_argument('--title',
help='Localized title of the video to be set.',
default='Localized Title')
# The localized description for the specified language.
parser.add_argument('--description',
help='Localized description of the video to be set.',
default='Localized Description')
args = parser.parse_args()
if not args.video_id:
exit('Please specify video id using the --video_id= parameter.')
youtube = get_authenticated_service()
try:
if args.action == 'set':
set_video_localization(youtube, args)
elif args.action == 'get':
get_video_localization(youtube, args)
elif args.action == 'list':
list_video_localizations(youtube, args)
except HttpError, e:
print 'An HTTP error %d occurred:\n%s' % (e.resp.status, e.content)
else:
print 'Set and retrieved localized metadata for a video