--- name: "google" section: "1" platform: "linux" package: "googlecl" version: "0.9.9-1" release: "Debian 6.0 (Squeeze)" platforms: ["linux"] url: "https://new.carta.tech/google" --- # google(1) command-line access to (some) Google services ## NAME google - command-line access to (some) Google services ## SYNOPSIS **google** \[*picasa\|blogger\|youtube\|docs\|contacts\|calendar*\] *TASK* \[*options*\] ## DESCRIPTION This program provides command-line access to (some) google services via their gdata APIs. Called without a service name, it starts an interactive session. Available tasks for service picasa: 'get', 'create', 'list', 'list-albums', 'tag', 'post', 'delete' - get: Download albums - Requires: none Optional: title, owner, format Arguments: LOCATION - create: Create an album - Requires: title Optional: date, summary, tags Arguments: PATH\_TO\_PHOTOS - list: List photos - Requires: delimiter Optional: title, query, owner - list-albums: List albums - Requires: delimiter Optional: title, owner - tag: Tag photos - Requires: tags AND (title OR query) Optional: owner - post: Post photos to an album - Requires: title Optional: tags, owner Arguments: PATH\_TO\_PHOTOS - delete: Delete photos or albums - Requires: (title OR query) Available tasks for service blogger: 'post', 'tag', 'list', 'delete' - post: Post content. - Requires: none Optional: blog, title, tags Arguments: PATH\_TO\_CONTENT or CONTENT - tag: Label posts - Requires: tags AND title Optional: blog - list: List posts in a blog - Requires: delimiter Optional: blog, title, owner - delete: Delete a post. - Requires: title Optional: blog Available tasks for service youtube: 'post', 'tag', 'list', 'delete' - post: Post a video. - Requires: category AND devkey Optional: title, summary, tags Arguments: PATH\_TO\_VIDEO - tag: Add tags to a video and/or change its category. - Requires: devkey AND title AND (category OR tags) - list: List videos by user. - Requires: delimiter Optional: title, owner - delete: Delete videos. - Requires: devkey Optional: title Available tasks for service docs: 'edit', 'delete', 'list', 'upload', 'get' - edit: Edit a document - Requires: title Optional: format, editor, folder - delete: Delete documents - Requires: none Optional: title - list: List documents - Requires: delimiter Optional: title, folder - upload: Upload a document - Requires: none Optional: title, folder, format Arguments: PATH\_TO\_FILE - get: Download a document - Requires: (title OR folder) Optional: format Arguments: LOCATION Available tasks for service contacts: 'list', 'list-groups', 'add', 'add-groups', 'delete-groups', 'delete' - list: List contacts - Requires: none Arguments: Fields to show (example: name,email) - list-groups: List contact groups - Requires: none Arguments: Specific groups to list (if any) - add: Add contacts - Requires: none Arguments: "name,email" pair or CSV filename - add-groups: Add contact group(s) - Requires: none Arguments: Group name(s) - delete-groups: Delete contact group(s) - Requires: none Arguments: Group name(s) - delete: Delete contacts - Requires: none Arguments: names of contact(s) to delete (e.g. "John Doe" "Jane Doe") Available tasks for service calendar: 'add', 'list', 'today', 'delete' - add: Add event to a calendar - Requires: none Optional: cal Arguments: QUICK\_ADD\_TEXT - list: List events on a calendar - Requires: delimiter Optional: title, query, date, cal - today: List events for the next 24 hours - Requires: delimiter Optional: title, query, cal - delete: Delete event from a calendar - Requires: (title OR query) Optional: date, cal ## OPTIONS - **--version** show program's version number and exit - **-h**, **--help** show this help message and exit - **--blog**=*BLOG* Blogger only - specify a blog other than your primary. - **--cal**=*CAL* Calendar only - specify a calendar other than your primary. - **-c** CATEGORY, **--category**=*CATEGORY* YouTube only - specify video categories as a commaseparated list, e.g. "Film, Travel" - **--config**=*CONFIG* Specify location of config file. - **--devtags**=*DEVTAGS* YouTube only - specify developer tags as a commaseparated list. - **--devkey**=*DEVKEY* YouTube only - specify a developer key - **-d** DATE, **--date**=*DATE* Date in YYYY-MM-DD format. Picasa only - sets the date of the album Calendar only - date of the event to add / look for. Can also specify a range with a comma: "YYYY-MM-DD", events between date and future. "YYYYMM-DD,YYYY-MM-DD" events between two dates. - **--debug** Enable all debugging output, including HTTP data - **--delimiter**=*DELIMITER* Specify a delimiter for the output of the list task. - **--draft** Blogger only - post as a draft - **--editor**=*EDITOR* Docs only - editor to use on a file. - **-f** FOLDER, **--folder**=*FOLDER* Docs only - specify folder(s) to upload to / search in. - **--format**=*FORMAT* Docs only - format to download documents as. - **--hostid**=*HOSTID* Label the machine being used. - **-n** TITLE, **--title**=*TITLE* Title of the item - **--no-convert** Google Apps Premier only - do not convert the file on upload. (Else converts to native Google Docs format) - **-o** OWNER, **--owner**=*OWNER* Username or ID of the owner of the resource. For example, 'picasa list-albums **-o** bob' to list bob's albums - **-q** QUERY, **--query**=*QUERY* Full text query string for specifying items. Searches on titles, captions, and tags. - **--quiet** Print only prompts and error messages - **--reminder**=*REMINDER* Calendar only - specify time for added event's reminder, e.g. "10m", "3h", "1d" - **-s** SUMMARY, **--summary**=*SUMMARY* Description of the upload, or file containing the description. - **-t** TAGS, **--tags**=*TAGS* Tags for item, e.g. "Sunsets, Earth Day" - **-u** USER, **--user**=*USER* Username to log in with for the service. - **-v**, **--verbose** Print all messages. ## EXAMPLES ``` google blogger post --title 'foo' 'command line posting' google calendar add 'Lunch with Jim at noon tomorrow' google contacts list name,email >contacts.csv google docs edit --title 'Shopping list' google.py picasa create --title 'Cat Photos' ~/photos/cats/*.jpg google youtube post --category Education killer_robots.avi ```