Here’s a walkthrough I recently sent to a customer who had questions about how the Google Apps Uploader works. I’m posting it here for future reference.

1) Using either the “Conversion Wizard” or “Advanced Conversion” tool in Emailchemy’s toolbox, convert your mail to Standard mbox Format, giving it a name like “converted”.

2) Switch over to Emailchemy’s Google Apps Uploader tool, select the “converted” folder and enter the target email account’s address (the account that you want to receive the uploaded messages) and leave the default settings for the other options for now.

3) When you click the “upload” button, you’ll have to authenticate to Google Apps. The account you authenticate with must be authorized to upload messages or be the domain administrator. The administrator may also choose to allow specific account holders to
upload their own, too. Also, the “upload email” feature must be enabled from the domain admin console before this works. If you are behind a web proxy server, click the “proxy” button and enter the details.

4) Click “login”

As the upload is going on, you may get a timeout message if you lose connectivity or if a message is taking too long to upload. The upload thread is still going even though it is asking you for what to do next, so you can safely step away from the computer. When the connection is restored and a response comes back from Google, the timeout dialog will go away by itself. In other words, it assumes you want to keep waiting even if you don’t explicity say so.

If an upload error occurs during the upload, Emailchemy will automatically retry before performing the action you specified on the first screen (ask, skip, or stop). If the failure repeats, Emailchemy will perform the specified action. If it asks you, you can choose to skip or stop or always skip.

If you stop an upload for any reason, Emailchemy will ask you if you want to resume the next time you start the Uploader.

When finished, Emailchemy will report the number of messages “processed” — this is the number of messages Emailchemy tried to upload, not adjusted for the ones you told it to skip. This number should be the same as the number of messages converted, reported by the Conversion Wizard tool.

Gmail will take up to an hour to display all the uploaded messages. Then, any messages that was “read” will not be in the Inbox – they will be in the “All Mail” folder. Only “new” or “unread” messages will be in the Inbox.

Emailchemy tags/labels every message with a timestamp of the upload event (something like “upload20090120”). This is useful in that you can click on this label to see the list of all uploaded messages, and even delete all the messages with this tag.

Again, keep in mind that Gmail gives you “conversation” counts, not message counts, so the conversation count will likely not match the number of messages uploaded that Emailchemy reported. Google uses some fuzzy logic to try to group messages into conversations, so things may get grouped together that should not be grouped together, and that is an unavoidable feature of the Gmail interface.

Google Apps Uploader Walk-through
Tagged on: