Google Colab API

As pointed out in the other answer, Colab Notebooks are files on your Google Drive. Hence, sharing them or retrieving their contents can be done via the Google Drive API (from what I understand you can use the webContentLink to download it).

However, your first question is:

Where is the Google Colab API?

For anyone coming here from Google trying to find the official Google Colab API (because it's one of the top results when googling for now), here is the answer:

[As of summer 2020] Since this is merely a research project, there is no official API documentation and very limited documentation.

Official Documentation (very limited)

  • Google Colab: Official FAQ
  • The Google Colab: Official Feature Demo exemplifies most features. Use it to learn many of its capabilities.

The API in code

Beyond those resources, your best bet would be going to the Official Github Repository. Here are some highlights from the code:

  • Github: google.colab
  • Github: google.colab.drive
  • Github: google.colab.drive.mount (used in quite a few snippets)
  • Github: google.colab.files (provides download and upload utilities)
  • Github: google.colab.snippets (add snippets to the snippets list programmatically; FYI: you can find all snippets by going to Insert -> Snippets)
  • Github: all packages

More Notes

The FAQ explains many important mechanics. Highlights include:

It’s a Jupyter notebook environment that requires no setup to use.

Convinient!

I heartly recommend checking out the Official Feature Demo; it's how I found out that it even supports LaTeX and MathJax! (but then again that might not come as news to someone with experience in Jupyter) 😄

Virtual Machine

The FAQ also mentions...

Code is executed in a virtual machine dedicated to your account. Virtual machines are recycled when idle for a while, and have a maximum lifetime enforced by the system.

That is why you can execute all kinds of the usual system calls (e.g. !pip install, open etc.) and it just works.

However that is also why when you come back the next day...

  1. drive.mount asks for your permission again
  2. you have to re-install all packages
  3. any newly created files are all gone (unless you put em in a drive-mounted folder)

Google Colab Notebooks are just like a normal file in Google Drive.

So, you can use Drive API to manage them just like any Drive files.

For example, you can share notebooks with Drive REST API as documented here

https://developers.google.com/drive/api/v3/manage-sharing