View Fabrizio Accatino's profile on LinkedIn
GDocBackup‎ > ‎

GDocBackup FAQ


1 - GDocBackup creates wrong or corrupted .doc files (MS word(c))
GDocBackup uses  the official Google Data APIs (.NET version). So the quality, accuracy and correctness of the exported files is out of the control of GDocBackup. If you encounter problems in the exported documents (i.e. the exported doc is not similar to the original on Google Docs), contact Google Docs support forum. 

2 - Pdf backup: GDocBackup does not backup (export) pdf files.
GDocBackup uses the official Google GData .NET Client Library. The library works upon the Google Data APIs version 2.0. The Google APIs version 2.0 does not allow to download pdf files.  The new APIs version 3.0 (actually a "lab") allows pdfs download. Unfortunately GData .NET Client Library runs on APIs version 2.0.  
At the moment there is not a planned date for a new version of GData .NET Lib. As soon as it will be available, a new version of GDocbackup will be released.
(SOLVED in GDocBackup 0.4.13)

3 - Howto run GDocBack (on Linux)
GDocBackup runs on Mono. I tested it with Mono 1.9.1 on Ubuntu 8.10 and on OpenSuse 11.1. 
Depending on your envieronment, run it as:
    ./GDocBackup.exe
or 
    mono ./GDocBackup.exe

4 - Problems running GDocBack (on Linux)
You get an error like this:
** (./GDocBackup.exe:1779): WARNING **: The following assembly referenced from /xxxxxxxxxxxx/GDocBackup.exe could not be loaded:
     Assembly:   System.Windows.Forms    (assemblyref_index=0)
     Version:    2.0.0.0
     Public Key: b77a5c561934e089
The assembly was not found..........
Your Mono installation is missing the libmono-winforms2.0-cil package (Mono System.Windows.Forms library (for CLI 2.0)).
Install it using Packages Manager (also install all the suggested related packages).

5 - Errors connecting to Google servers (on Linux)
If you get an error like this:
Google.GData.Client.GDataRequestException:
Execution of request failed:
http://docs.google.com/feeds/documents/private/full?max-results=100&showfolders=true --->
System.Net.WebException: The remote server returned an error: (401) Authorization required.
try to import https certificates in Mono. Use mozroots utility.  Details here.

6 - Problems running GDocBackup (on Mac)
Read the HowTo.  
If you get the following error, try to import https cerficate with mozroot (see HowTo).



7 - GDocBackup crashes with the error "Key not valid for use in specified state" (Windows)
The error is:
System.Security.Cryptography.CryptographicException: Key not valid for use in specified state
at System.Security.Cryptography.ProtectedData.Unprotect(Byte[] encryptedData, Byte[] optionalEntropy, DataProtectionScope scope)
...
The error is caused by Windows Data Protection API (DPAPI). GDocBackup uses DPAPI to securelly store sensitive data.
If an administrator of your Windows system reset your user password, DPAPI is no longer able to decrypt saved data. So the error.
This behaviour of DPAPI is by design. From MS TechNet: (http://technet.microsoft.com/en-us/library/bb457065.aspx)
The most common issue with Windows XP occurs when a local user on a workgroup computer has their password reset by a local administrator. When a local password reset occurs, the DPAPI master key is lost, and the user will no longer be able to access their private keys associated with encrypted files. This behavior is designed as a security feature against offline attacks and does not apply to domain joined machines with domain based user accounts.
The TechNet article is quite old. The behaviour is the same also on Windows Vista and Seven.
--> GDocBackup 0.4.11 and later manages such situation <---

8 - GDocBackup does not download document of the new format
The new format of document in Google Docs are not supported. Actually the problem seems to be related to Google APIs. Hope they solve the problem.
http://code.google.com/p/gdocbackup/issues/detail?id=22

[SOLVED]

9 - GDocBackup overwrites documents with the same name in tha same folder
Google Docs allows you to create items (documents, spreadsheets, presentations and drawings) with the same name, also in the same folder. This is a great feature but GDocBackup is not actually able to manage such a situation. It overwrites the same file. Example: you have Foo (document) and Foo (presentation) in the same folder. GDocBackup export Foo (document) and immediately Foo (presentation). At the end, on you harddisk, you only have content from Foo (presentation).
[I'm working on an "alert-system" for such situations]

10 - How to run GDocBackup from Scheduled Taks (Windows) without user clicks
Add a task, pointing to gdocbackup.exe  (tipically C:\Program Files (x86)\GDocBackup\GDocBackup.exe).  Add the argument -autostart.

11 - CaptchaRequiredException
If you get an error like "CaptchaRequiredException" then your google account is locked and you have to unlock it. Common reason: too many attempts to login with a wrong password.
The log shows an error like this:
Google.GData.Client.CaptchaRequiredException: Captcha required
  at Google.GData.Client.Utilities.QueryClientLoginToken .....
First of all: check if you have entered the right username and password. 
If you account continues to not work, try this:
 - close gdocbackup
 - open your browser and login to google (gmail or documents). 
 - google will request you a "captcha challenge"
 - enter the sequence of characters and you will login successfully
 - start gdocbackup
 - start the backup process