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

NAME

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

SYNOPSIS

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

DESCRIPTION

12       This program provides command-line access to (some) google services via
13       their gdata APIs.  Called without a service name, it starts an interac‐
14       tive session.
15
16       Available   tasks   for   service   picasa:  'get',  'create',  'list',
17       'list-albums', 'tag', 'post', 'delete'
18
19              get: Download albums
20
21              Requires: none Optional: title, owner, format  Arguments:  LOCA‐
22              TION
23
24              create: Create an album
25
26              Requires:   title   Optional:  date,  summary,  tags  Arguments:
27              PATH_TO_PHOTOS
28
29              list: List photos
30
31              Requires: delimiter Optional: title, query, owner
32
33              list-albums: List albums
34
35              Requires: delimiter Optional: title, owner
36
37              tag: Tag photos
38
39              Requires: tags AND (title OR query) Optional: owner
40
41              post: Post photos to an album
42
43              Requires: title Optional: tags, owner Arguments: PATH_TO_PHOTOS
44
45              delete: Delete photos or albums
46
47              Requires: (title OR query)
48
49       Available tasks for service blogger: 'post', 'tag', 'list', 'delete'
50
51              post: Post content.
52
53              Requires:  none   Optional:   blog,   title,   tags   Arguments:
54              PATH_TO_CONTENT or CONTENT
55
56              tag: Label posts
57
58              Requires: tags AND title Optional: blog
59
60              list: List posts in a blog
61
62              Requires: delimiter Optional: blog, title, owner
63
64              delete: Delete a post.
65
66              Requires: title Optional: blog
67
68       Available tasks for service youtube: 'post', 'tag', 'list', 'delete'
69
70              post: Post a video.
71
72              Requires:  category  AND  devkey  Optional: title, summary, tags
73              Arguments: PATH_TO_VIDEO
74
75              tag: Add tags to a video and/or change its category.
76
77              Requires: devkey AND title AND (category OR tags)
78
79              list: List videos by user.
80
81              Requires: delimiter Optional: title, owner
82
83              delete: Delete videos.
84
85              Requires: devkey Optional: title
86
87       Available tasks for service docs: 'edit', 'delete',  'list',  'upload',
88       'get'
89
90              edit: Edit a document
91
92              Requires: title Optional: format, editor, folder
93
94              delete: Delete documents
95
96              Requires: none Optional: title
97
98              list: List documents
99
100              Requires: delimiter Optional: title, folder
101
102              upload: Upload a document
103
104              Requires:   none  Optional:  title,  folder,  format  Arguments:
105              PATH_TO_FILE
106
107              get: Download a document
108
109              Requires: (title OR folder) Optional: format Arguments: LOCATION
110
111       Available tasks for service  contacts:  'list',  'list-groups',  'add',
112       'add-groups', 'delete-groups', 'delete'
113
114              list: List contacts
115
116              Requires: none Arguments: Fields to show (example: name,email)
117
118              list-groups: List contact groups
119
120              Requires: none Arguments: Specific groups to list (if any)
121
122              add: Add contacts
123
124              Requires: none Arguments: "name,email" pair or CSV filename
125
126              add-groups: Add contact group(s)
127
128              Requires: none Arguments: Group name(s)
129
130              delete-groups: Delete contact group(s)
131
132              Requires: none Arguments: Group name(s)
133
134              delete: Delete contacts
135
136              Requires:  none  Arguments:  names of contact(s) to delete (e.g.
137              "John Doe" "Jane Doe")
138
139       Available tasks for service calendar: 'add', 'list', 'today', 'delete'
140
141              add: Add event to a calendar
142
143              Requires: none Optional: cal Arguments: QUICK_ADD_TEXT
144
145              list: List events on a calendar
146
147              Requires: delimiter Optional: title, query, date, cal
148
149              today: List events for the next 24 hours
150
151              Requires: delimiter Optional: title, query, cal
152
153              delete: Delete event from a calendar
154
155              Requires: (title OR query) Optional: date, cal
156

OPTIONS

158       --version
159              show program's version number and exit
160
161       -h, --help
162              show this help message and exit
163
164       --blog=BLOG
165              Blogger only - specify a blog other than your primary.
166
167       --cal=CAL
168              Calendar only - specify a calendar other than your primary.
169
170       -c CATEGORY, --category=CATEGORY
171              YouTube only - specify  video  categories  as  a  commaseparated
172              list, e.g. "Film, Travel"
173
174       --config=CONFIG
175              Specify location of config file.
176
177       --devtags=DEVTAGS
178              YouTube only - specify developer tags as a commaseparated list.
179
180       --devkey=DEVKEY
181              YouTube only - specify a developer key
182
183       -d DATE, --date=DATE
184              Date  in  YYYY-MM-DD  format. Picasa only - sets the date of the
185              album  Calendar only - date of the event to add / look for.  Can
186              also  specify a range with a comma: "YYYY-MM-DD", events between
187              date  and  future.  "YYYYMM-DD,YYYY-MM-DD"  events  between  two
188              dates.
189
190       --debug
191              Enable all debugging output, including HTTP data
192
193       --delimiter=DELIMITER
194              Specify a delimiter for the output of the list task.
195
196       --draft
197              Blogger only - post as a draft
198
199       --editor=EDITOR
200              Docs only - editor to use on a file.
201
202       -f FOLDER, --folder=FOLDER
203              Docs only - specify folder(s) to upload to / search in.
204
205       --format=FORMAT
206              Docs only - format to download documents as.
207
208       --hostid=HOSTID
209              Label the machine being used.
210
211       -n TITLE, --title=TITLE
212              Title of the item
213
214       --no-convert
215              Google  Apps  Premier  only - do not convert the file on upload.
216              (Else converts to native Google Docs format)
217
218       -o OWNER, --owner=OWNER
219              Username or ID of  the  owner  of  the  resource.  For  example,
220              'picasa list-albums -o bob' to list bob's albums
221
222       -q QUERY, --query=QUERY
223              Full text query string for specifying items. Searches on titles,
224              captions, and tags.
225
226       --quiet
227              Print only prompts and error messages
228
229       --reminder=REMINDER
230              Calendar only - specify time for added  event's  reminder,  e.g.
231              "10m", "3h", "1d"
232
233       -s SUMMARY, --summary=SUMMARY
234              Description of the upload, or file containing the description.
235
236       -t TAGS, --tags=TAGS
237              Tags for item, e.g. "Sunsets, Earth Day"
238
239       -u USER, --user=USER
240              Username to log in with for the service.
241
242       -v, --verbose
243              Print all messages.
244

EXAMPLES

246       google blogger post --title 'foo' 'command line posting'
247
248       google calendar add 'Lunch with Jim at noon tomorrow'
249
250       google contacts list name,email >contacts.csv
251
252       google docs edit --title 'Shopping list'
253
254       google.py picasa create --title 'Cat Photos' ~/photos/cats/*.jpg
255
256       google youtube post --category Education killer_robots.avi
257
258
259
260google 0.9.9                       July 2010                         GOOGLE(1)