5. Advanced usage

5.1. Working with several Google Drives

A person may have several Google accounts, hence several Google Drives. XXE allows to work directly on all these Drives at the same time. For example, copy some files by dragging files found in a first Drive and then dropping them onto a second Drive.

Example: let's suppose Jane has two Google accounts. First account is associated to email address . Second account is associated to (more personal) email address .

She'll use "google:/" to refer to the root folder of her default Google Drive, the one associated to email address . (Remember how she authorized XXE to access her Google Drive: she first signed in to her Google account. See above.)

She'll use "google://personal/" to refer to the root folder of her other Google Drive. Here, "personal" is an arbitrary Drive identifier which is entirely Jane's choice.

Of course, the first time Jane will use "google://personal/", she'll be prompted to authorize XXE to access her "personal" Drive, just like she was prompted to authorize XXE to access her default Drive. When this will happen, Jane will take great care to sign in to her Google account, and not to her Google account[6].

About "google:" URLs

Technically speaking, "google:/" is an URL having no authority, while "google://personal/" is an URL having an authority called "personal". The two slashes ("//") preceding the name of the authority are absolutely required.

5.2. Revoking XXE authorization to access your Google Drive

Note

You may want to revoke XXE authorization to access your Google Drive if you find that the "Google® virtual drive plug-in" is not useful. But there are also other, more imperative, reasons to do that.

When the "Browse Files" tool (and also the URL chooser dialog box) constantly shows a blank window (as if your Google Drive were completely empty), when opening a document in XXE constantly fails after displaying the following "invalid_grant" alert:

then it's time to revoke XXE authorization to access your Google Drive in order to be able to grant this authorization again, starting from a clean room state.

This is a two-step operation. First step, actually revoke XXE authorization to access your Google Drive:

  1. Start your Web browser and sign in to the Google account associated to the Google Drive accessed by XXE.

  2. Click your photo. This displays a popup window.

  3. Click Account. The Web browser now displays an "Accounts" page having a navigation menu at its left.

  4. Click "Security" and then "Account Permissions".

  5. Click "XMLmind XML Editor" and then click "Revoke access".

Second step, inform XXE about what you did:

  1. Select menu item OptionsPreferences.

  2. After the Preferences dialog box is displayed, select "Add-on|Google Drive" in its left pane.

  3. Select the identifier of the Drive for which you want to revoke XXE authorization. Note that "(My Drive)" is the identifier automatically given to your default Google Drive (see Section 5.1, “Working with several Google Drives”).

  4. Click Remove.

  5. Click OK to close the Preferences dialog box.

5.3. Miscellaneous useful information about this add-on

  • It's not possible to download (and hence, open in XXE) files created using Google Docs. Moreover listing the revisions of this kind of files always shows a blank window.

  • Write locks are implemented by the means of the description field of a file[7]. Therefore, you must not hand-edit this field in the case of documents edited using XXE.

  • XXE authorizations to access one or more Google Drives are stored in file XXE_user_preferences_dir/gdrive/StoredCredentials, where directory XXE_user_preferences_dir/ is:

    • $HOME/.xxe7/ on Linux.

    • $HOME/Library/Application Support/XMLmind/XMLEditor7/ on the Mac.

    • %APPDATA%\XMLmind\XMLEditor7\ on Windows XP, Vista, 7 and 8.

      Example: C:\Documents and Settings\john\Application Data\XMLmind\XMLEditor7\ on Windows XP. C:\Users\john\AppData\Roaming\XMLmind\XMLEditor7\ on Windows Vista, 7 and 8.

      If you cannot see the "Application Data" directory using Microsoft Windows File Manager, turn on Tools>Folder Options>View>File and Folders>Show hidden files and folders.

    If you use XXE on several computers, after authorizing XXE on one computer, you may safely copy StoredCredentials to the XXE_user_preferences_dir/gdrive/ directory of the other computer. Doing this will avoid you to also authorize XXE to access Google Drive from the other computer.



[6] Otherwise, "google:/" and "google://personal/" would be two different ways to refer to the same Google Drive.

[7] Google Drive does not natively support file locking. Though there are more elegant ways to implement application-level file locking, we have chosen to “hijack” the description field for efficiency reasons.