Since Google Bookmarks™ does not provide much documentation, we make available to other Google Bookmarks™ users the following tidbits which we learned during development of Bookdog 4.2.
List of TopicsGoogle Bookmarks™ are associated with Google Accounts. You will have a separate set of Google Bookmarks™ available for each Google account. Bookdog populates Google Bookmarks™ items in its File menu by looking in your Mac OS X Keychain for passwords you have stored to the domain google.com.
Support of non-HTTP URL such as feed://Google Bookmarks™ do not seem to support bookmarks with non-HTTP URL such as feed://. Because this may be an evolving situation, please refer to our support web page for current information.
Dates of Google Bookmarks™When viewing your Google Bookmarks™ at http://google.com/bookmarks, the date which appears after the bookmark name is the date that it was added or modified. This is the only "date" attribute supported by Google Bookmarks.
Duplicate BookmarksGoogle does not allow duplicates bookmarks. If you submit such a bookmark which duplicates an existing bookmark, the existing bookmark is deleted, and a new bookmark added with other attributes of your new submission.
Canonizing of URLsGoogle "canonizes" all URLs you give to it to a canonical form. This means:
Bookdog uses the same URL Loading System in your Mac as Safari does. If you log into Google in Safari and check the box "Remember me on this computer", the URL Loading System will store your credential as a cookie, and then Bookdog will be able to access your Google Bookmarks™ too, until you log out. If Bookdog cannot find such a cookie, it will look for the required password in your Mac OS X Keychain. If it finds it, and you have not previously authorized Bookdog to use it, Keychain will ask your permission. If Bookdog does not find the password even in Keychain, Bookdog will ask you to to enter it into as secure field, and give you the option to store it in Keychain for future use (with your permission) by Bookdog, Safari, or any application which is smart enough to look there for it ("Keychain-aware").
Deleting Bookmarks Can Take A Long TimeShort answer: We did the best we could, but that's how long it takes.
Longer answer: Some operations, such as deleting bookmarks, require that requests be sent to Google one at a time, which is slow.
In addition, Bookdog has to know the ID number of a bookmark in order to delete it, and the ID number is assigned by Google. To avoid having to re-download all of the bookmarks every time a change is made, Bookdog maintains a local cache of your bookmarks as they appear on Google's server, but this cache is missing the ID numbers of new bookmarks which have been uploaded but never downloaded by Bookdog. So if you decide to delete new bookmarks after adding them, it takes even longer, because Bookdog has to then go to Google and get ID numbers for each of these bookmarks before it can delete them. (If there are only a few, it asks for them individually, otherwise if downloads them all. Bookdog knows about how long each operation takes and does whichever will be faster).
Consecutive Spaces in Bookmark NamesGoogle will not allow consecutive spaces in bookmark names (titles). If Bookdog uploads a name containing consecutive spaces, Google collapses them all into one space.