1GOOGLE(1)                        User Commands                       GOOGLE(1)
2
3
4

NAME

6       google - command-line access to (some) Google services
7

SYNOPSIS

9       google     [help|picasa|blogger|youtube|docs|contacts|calendar|finance]
10       TASK [options]
11

DESCRIPTION

13       This program provides command-line access to (some) google services via
14       their gdata APIs.  Called without a service name, it starts an interac‐
15       tive session.
16
17       NOTE: GoogleCL will interpret arguments  as  required  options  in  the
18       order  they  appear in the descriptions below, excluding options set in
19       the configuration  file  and  non-primary  terms  in  parenthesized  OR
20       groups. For example:
21
22              $ google picasa get my_album .
23
24       is interpreted as "google picasa get --title=my_album --dest=.
25
26              $ google contacts list john
27
28       is  interpreted  as  "$ google contacts list --fields=<config file def>
29       --title=john --delimiter=," (only true if  you  have  not  removed  the
30       default definition in the config file!)
31
32              $ google docs get my_doc .
33
34       is  interpreted  as "$ google docs get --title=my_doc --dest=.  (folder
35       is NOT set, since the title option is satisfied first.)
36
37       Available  tasks  for  service   picasa:   'get',   'create',   'list',
38       'list-albums', 'tag', 'post', 'delete'
39
40              get: Download albums
41
42              Requires: title AND dest Optional: owner, format, photo
43
44              create: Create an album
45
46              Requires: title Optional: src, date, summary, tags, access
47
48              list: List photos
49
50              Requires:  fields  AND  delimiter Optional: title, query, owner,
51              photo
52
53              list-albums: List albums
54
55              Requires: fields AND delimiter Optional: title, owner
56
57              tag: Tag/caption photos
58
59              Requires: (title OR  query)  AND  (tags  OR  summary)  Optional:
60              owner, photo
61
62              post: Post photos to an album
63
64              Requires: title AND src Optional: tags, owner, photo, summary
65
66              delete: Delete photos or albums
67
68              Requires: (title OR query) Optional: photo
69
70       Available tasks for service blogger: 'post', 'tag', 'list', 'delete'
71
72              post: Post content.
73
74              Requires: src AND blog Optional: title, tags, access
75
76              tag: Label posts
77
78              Requires: blog AND title AND tags
79
80              list: List posts in a blog
81
82              Requires: fields AND blog AND delimiter Optional: title, owner
83
84              delete: Delete a post.
85
86              Requires: blog AND title
87
88       Available tasks for service youtube: 'post', 'tag', 'list', 'delete'
89
90              post: Post a video.
91
92              Requires:  src AND category AND devkey Optional: title, summary,
93              tags, access
94
95              tag: Add tags to a video and/or change its category.
96
97              Requires: title AND (tags OR category) AND devkey
98
99              list: List videos by user.
100
101              Requires: fields AND delimiter Optional: title, owner
102
103              delete: Delete videos.
104
105              Requires: title AND devkey
106
107       Available tasks for service docs: 'edit', 'delete',  'list',  'upload',
108       'get'
109
110              edit: Edit a document
111
112              Requires: title Optional: format, editor, folder
113
114              delete: Delete documents
115
116              Requires: title Optional: folder
117
118              list: List documents
119
120              Requires: fields AND delimiter Optional: title, folder
121
122              upload: Upload a document
123
124              Requires: src Optional: title, folder, format
125
126              get: Download a document
127
128              Requires: (title OR folder) AND dest Optional: format
129
130       Available  tasks  for  service  contacts: 'list', 'list-groups', 'add',
131       'add-groups', 'delete-groups', 'delete'
132
133              list: List contacts
134
135              Requires: fields AND title AND delimiter
136
137              list-groups: List contact groups
138
139              Requires: title
140
141              add: Add contacts
142
143              Requires: src
144
145              add-groups: Add contact group(s)
146
147              Requires: title
148
149              delete-groups: Delete contact group(s)
150
151              Requires: title
152
153              delete: Delete contacts
154
155              Requires: title
156
157       Available tasks for service calendar: 'add', 'list', 'today', 'delete'
158
159              add: Add event to a calendar
160
161              Requires: src Optional: cal
162
163              list: List events on a calendar
164
165              Requires: fields AND delimiter Optional: title, query, date, cal
166
167              today: List events for the next 24 hours
168
169              Requires: fields AND delimiter Optional: title, query, cal
170
171              delete: Delete event from a calendar
172
173              Requires: (title OR query) Optional: date, cal
174
175       Available tasks for service finance:  'list-txn',  'delete-pos',  'cre‐
176       ate-pos',  'delete-txn',  'create',  'create-txn',  'list', 'list-pos',
177       'delete'
178
179              list-txn: List transactions
180
181              Requires: title AND ticker
182
183              delete-pos: Delete positions
184
185              Requires: title Optional: ticker
186
187              create-pos: Create position
188
189              Requires: title AND ticker
190
191              delete-txn: Delete transactions
192
193              Requires: title AND ticker Optional: txnid
194
195              create: Create a portfolio
196
197              Requires: title AND currency
198
199              create-txn: Create transaction
200
201              Requires: title AND  ticker  AND  ttype  AND  shares  AND  price
202              Optional: shares, price, date, commission, currency, notes
203
204              list: List portfolios
205
206              Requires: none Optional: fields
207
208              list-pos: List positions
209
210              Requires: title Optional: fields
211
212              delete: Delete portfolios
213
214              Requires: title
215

OPTIONS

217       --version
218              show program's version number and exit
219
220       -h, --help
221              show this help message and exit
222
223       --access=ACCESS
224              Specify access/visibility level of an upload
225
226       --blog=BLOG
227              Blogger only - specify a blog other than your primary.
228
229       --cal=CAL
230              Calendar only - specify a calendar other than your primary.
231
232       -c CATEGORY, --category=CATEGORY
233              YouTube  only  -  specify  video  categories as a commaseparated
234              list, e.g. "Film, Travel"
235
236       --commission=COMMISSION
237              Finance only - specify commission for transaction
238
239       --config=CONFIG
240              Specify location of config file.
241
242       --currency=CURRENCY
243              Finance only - specify currency for portfolio
244
245       --devtags=DEVTAGS
246              YouTube only - specify developer tags as a commaseparated list.
247
248       --devkey=DEVKEY
249              YouTube only - specify a developer key
250
251       -d DATE, --date=DATE
252              Calendar only - date of the event  to  add/look  for.  Can  also
253              specify a range with a comma. Picasa only - sets the date of the
254              album Finance only - transaction creation date
255
256       --debug
257              Enable all debugging output, including HTTP data
258
259       --delimiter=DELIMITER
260              Specify a delimiter for the output of the list task.
261
262       --dest=DEST
263              Destination. Typically, where to save data being downloaded.
264
265       --draft
266              Blogger only - post as a draft. Shorthand for --access=draft
267
268       --editor=EDITOR
269              Docs only - editor to use on a file.
270
271       --fields=FIELDS
272              Fields to list with list task.
273
274       -f FOLDER, --folder=FOLDER
275              Docs only - specify folder(s) to upload to / search in.
276
277       --force-auth
278              Force validation  step  for  re-used  access  tokens  (Overrides
279              --skip-auth).
280
281       --format=FORMAT
282              Docs only - format to download documents as.
283
284       --hostid=HOSTID
285              Label the machine being used.
286
287       -n TITLE, --title=TITLE
288              Title of the item
289
290       --no-convert
291              Google  Apps  Premier  only - do not convert the file on upload.
292              (Else converts to native Google Docs format)
293
294       --notes=NOTES
295              Finance only - specify notes for transaction
296
297       -o OWNER, --owner=OWNER
298              Username or ID of  the  owner  of  the  resource.  For  example,
299              'picasa list-albums -o bob' to list bob's albums
300
301       --photo=PHOTO
302              Picasa only - specify title or name of photo(s)
303
304       --price=PRICE
305              Finance only - specify price for transaction
306
307       -q QUERY, --query=QUERY
308              Full text query string for specifying items. Searches on titles,
309              captions, and tags.
310
311       --quiet
312              Print only prompts and error messages
313
314       --reminder=REMINDER
315              Calendar only - specify time for added  event's  reminder,  e.g.
316              "10m", "3h", "1d"
317
318       --shares=SHARES
319              Finance only - specify amount of shares for transaction
320
321       --skip-auth
322              Skip validation step for re-used access tokens.
323
324       --src=SRC
325              Source. Typically files to upload.
326
327       -s SUMMARY, --summary=SUMMARY
328              Description of the upload, or file containing the description.
329
330       -t TAGS, --tags=TAGS
331              Tags for item, e.g. "Sunsets, Earth Day"
332
333       --ticker=TICKER
334              Finance only - specify ticker
335
336       --ttype=TTYPE
337              Finance  only  -  specify  transaction type, e.g. "Bye", "Sell",
338              "Buy to Cover", "Sell Short"
339
340       --txnid=TXNID
341              Finance only - specify transaction id
342
343       -u USER, --user=USER
344              Username to log in with for the service. If  not  provided  full
345              email  address  (e.g.  "foo"),  than  it  is  assumed  to  be in
346              gmail.com domain (e.g.  "foo@gmail.com"). If  you  want  to  use
347              another domain, provide full email address like "foo@bar.com"
348
349       -v, --verbose
350              Print all messages.
351
352       --yes  Answer "yes" to all prompts
353

EXAMPLES

355       google blogger post --title 'foo' 'command line posting'
356
357       google calendar add 'Lunch with Jim at noon tomorrow'
358
359       google contacts list --title '.*' --fields name,email,phone > contacts.csv
360
361       google docs edit --title 'Shopping list'
362
363       google picasa create --title 'Cat Photos' ~/photos/cats/*.jpg
364
365       google youtube post --category Education killer_robots.avi
366
367
368
369google ./google0.9.14            December 2012                       GOOGLE(1)