Google Drive Links URL format and query parameters

google-docs-api
Cédric NICOLAS picture Cédric NICOLAS · Jun 3, 2015 · Viewed 11.2k times · Source

I'm desperately trying to find where the google drive and google docs urls scheme and query parameters are documented. For example what is the usp= parameter which seems to have several possible values ? Also, why a link like this https://drive.google.com/drive/u/2/#folders/ will open a folder in Safari and Chrome without new authentication while a link like https://drive.google.com/drive/#folders/ will only work correctly in chrome. What is the meaning of u/2/ ? etc. Anyone knows how to find a complete documentation of these url schemes ?

Answer

Venkatesh Kumar picture Venkatesh Kumar · Jan 27, 2017

As the part about /u/2/ has already been satisfactorily explained, I'll try to explain the part about usp from my best understanding.

It seems to just be providing data on from where you got access to the document.

usp=docs_home is when you create a new document from Google Docs itself
usp=drivesdk is given when you get a link using the Drive SDK
usp=sharing is when you get a link from the sharing dialogue
usp=drive_web is what you get when you click on a document in the Docs homepage or in Drive usp=direct_url is seen on the Docs homepage when you directly go to sheets.google.com or slides.google.com

There are probably more to be found, but it doesn't seem to be doing anything other than likely providing referrer information. Replacing usp=sharing with anything else still doesn't seem to stop you from retrieving a document, and it seems unlikely that this would be a document-specific property as it is also seen on other Google URLs, like the slides/sheets homepage.

Related questions

Collapsing Elements in a Google Doc With Google Apps Script - Is This Possible?

I'd love to be able to collapse and expand sections in my Google Docs document, making large documents easier to navigate. I was wondering if this is possible with Google Apps Script, or if I'd be wasting my time trying …

Read More
How to upload a file to Google Drive using a Python script?

I need to backup various file types to GDrive (not just those convertible to GDocs formats) from some linux server. What would be the simplest, most elegant way to do that with a python script? Would any of the solutions …

Read More
Download a spreadsheet from Google Docs using Python

Can you produce a Python example of how to download a Google Docs spreadsheet given its key and worksheet ID (gid)? I can't. I've scoured versions 1, 2 and 3 of the API. I'm having no luck, I can't figure out their compilcated …

Read More