I have an application written with the legacy API: should I switch to the new GData-based API?
Yes. The legacy API will be around until at least August 30, 2008, but after that, its existence is not guaranteed. Please see the migration guide for help getting started.