Команда разработчиков Google Data API выпустила обновление для клиентской библиотеки Google Data на языке Python, которое поддерживает работу под Google App Engine. С помощью нее ваше приложение сможет использовать интерфейс AuthSub и получить доступ к пользовательским данным.

Джеф Скаддер, разработчик Google Data API и основной контрибьютор библиотеки Google Data Python client library, написал статью, в которой рассматриваются все шаги, которые необходимо выполнить для использования данных Google Data в приложении Google App Engine. Он также добавил пример такого приложения в проект Google App Engine sample code.

Попробуйте использование этих возможностей!

Google udostępnia biblioteki dla Javy które pozwalają nam komunikacje z popularnymi serwisami takimi jak Picasa, YouTube czy Calendar. Cała technologia oparta jest o autorski protokół GData który pozwala nam łączyć się z dowolnymi kanałami. Sam protokół nie jest nowością bo oparty jest o znane już wszystkim rozwiązania RSS czy ATOM, wiec każda przeglądarka tak naprawdę będzie się w stanie nim komunikować. Implementacją obsługującą GData Api jest Java Client Library for Google Data API pozywa na operacje na danych nie tylko na ich pobieranie, operacje te bazują na http put czy http delete. Same biblioteki mogą być pobrane ze strony http://code.google.com/p/gdata-java-client/downloads/list, z tego samego miejsca możemy też pobrać plugin do eclipsa który będzie zarządzał wymaganymi przez nas dodatkami.

Same źródła będą od nas wymagały pobrania dodatkowo bibliotek (strony Suna)

• JavaBeans Activation Framework
• Servlet API
• JavaMail API

Obecne wsparcie dla serwisów:

• Google mail
• Google Apps
• YouTube
• Picasa Web Albums
• Google Contacts
• Blogger
• Code Search
• Google Notebook
• Google Spreadsheets
• Google Base

Zaletą zastosowania tego rozwiązania jest rozdzielenie usług na pojedyncze pliki jar, także jeżeli chcemy używać Google Calendar importujemy tylko gdata-calendar-1.0.jar oraz podstawowe pliki gdata-client oraz gdata-core.
Sam proces tworzenia aplikacji sprowadza się do tworzenia odpowiednich zapytań które mogą być dynamicznie tworzone przez dostarczone biblioteki. Przykładem takiego zapytania jest :

Albumy użytkownika
http://picasaweb.google.com/data/feed/api/user/nazwa_użytkownika?kind=album

Zdjęcia z wybranego albumu
http://picasaweb.google.com/data/feed/api/user/nazwa_użytkownika/album/nazwa_albumu?kind=photo

Przeszukiwania publicznych albumów w poszukiwaniu Javy
http://picasaweb.google.com/data/feed/api/all?kind=photo&q=java&max-result=100

Budowa samej aplikacji pobierającej dane z naszego zapytania jest dość prosta bo sprowadza się tak naprawdę do paru linijek.



import java.net.URL;

import com.google.gdata.client.photos.PicasawebService;

import com.google.gdata.data.BaseEntry;

import com.google.gdata.data.photos.AlbumFeed;

public class AppsProvisioning {

public static void main(String[] args) {

try {

URL albumsURL = new URL("http://picasaweb.google.com/data/feed/api/user/nazwa_uzytkownika?kind=album");

PicasawebService myService = new PicasawebService("MyApp");

AlbumFeed myUserFeed = myService.getFeed(albumsURL,AlbumFeed.class);

for ( BaseEntry<BaseEntry> ea : myUserFeed.getEntries())

{

System.out.println(ea.getTitle().getPlainText());

System.out.println(ea.getHtmlLink().getHref());

}

}

catch(Exception ex)

{

ex.printStackTrace();

}

}

}

Efektem działania aplikacji jest wyświetlenie wszystkich albumów publicznych dla wybranej osoby, co ciekawe możemy także operować na danych które są prywatne po przez wcześniejsze uwierzytelnienie co możemy zrobić wprowadzając linijkę.

myService.setUserCredentials(arg0, arg1)


gdzie arg0 jest nazwą użytkownika, natomiast arg1 – hasłem.

Biblioteka posiada także rozwiązanie opierające się token co pozwala na zastosowanie w aplikacjach www, jednak wymaga od nas rejestracji strony na stronach Google która musi zostać następnie zweryfikowana.
Nie lubię pisać o czymś i nie pokazywać rzeczywistego działania rozwiązania więc poniżej został zaprezentowany kod aplikacji który dodaje nowy album do Picsasa Web Album.

public class AppsProvisioning {

public static void main(String[] args) {

try {

URL albumsURL = new URL("http://picasaweb.google.com/data/feed/api/user/nazwa_uzytkownika?kind=album");

PicasawebService myService = new PicasawebService("MyApp");

myService.setUserCredentials("user", "password");

AlbumFeed myUserFeed = myService.getFeed(albumsURL,AlbumFeed.class);

AlbumEntry newEntry = new AlbumEntry();

newEntry.setTitle(new PlainTextConstruct("Nowy Album"));

newEntry.setDescription(new PlainTextConstruct("Zdjecia z wakacji"));

myService.insert(albumsURL, newEntry);

}

catch(Exception ex)

{

ex.printStackTrace();

}

}

}

Podobne operacje możemy wykonywać na wszystkich usługach Google do których pojawiły się biblioteki.

27.06.2008

I'm currently using Google Data API at work. This API offers RESTful interfaces for several Google services, such as Calendar, Picasa, You Tube, Blogger, Google Documents, among others. There are also client libraries for Java, C# and Python, but these are actually tools to facilitate, rather than new interfaces. All client libraries access the RESTful interfaces, so by all acounts the API is RESTful.

What I'd like to comment is how easy it was for me the to get up to speed with the API. There are several pages explaining the API's features, the URIs, their use of HTTP method, return types, etc. Their design is pretty much compliant to all REST best practices (although they do use some query string parameters ocasionally). Being very familiar with this kind of web services, most of what I did was looking and saying: "Ok , this is how i expected it to be". And after less than one hour I was ready to begin using the API properly.

Worth noting is that there were no "Interface Document" to look at. Not anything similar to WSDL or any other IDL. What was there was just a simple and RESTful API that was pretty easy to use after you knew what the resources were and which operations they support. Several pages describing their protocol and the XML entities they use were enough for me to know how I was supposed to integrate with a reasonable amount of their services.

I don't even want of to think of how would it be if they had WS-*. Just to read the WSDL documents would take me more time than to read all their RESTful documentation. There would be a lot of operations and messages described in their WSDLs, and it'd be a massive reading to get the grasp of the API.

Fortunately Google (the most powerful web company) is embracing a RESTful design and it should probably take many other companies with it. They're also supporting the use of Atom and Atom Publishing Protocol, so many nice things should keep coming. Apache Abdera is already integrating Google Feed Server code, and hopefully we'll be able to use Abdera for most of Google's services.

Very very nice! By the way, I took a good look in the source code of Google Data API and it's very well implemented. They have a very interesting approach to manipulate feeds and entries. It makes it very easy to model a lot of stuff using just feeds and entries. It was an inspiring code inspection and I'm thankful Google also embraces open source :) These guys are good!

Benutzung im Java Desktop Client

Laden der Alben eines Benutzers

PicasawebService picasa = new PicasawebService("exampleCo-exampleApp-1");
String url = "http://picasaweb.google.com/data/feed/api/user/<username>?kind=album";
URL albumsUrl = new URL(url);
// Send the request for the user's albums.
AlbumFeed albums = picasa.getFeed(albumsUrl, AlbumFeed.class);
List<AlbumEntry> entries = albums.getEntries(AlbumEntry.class);
for (AlbumEntry album : entries) {
	//do something with the albums
}

Albumdetails Abrufen und Bilder eines Albums anzeigen

//URL for the AlbumFeed
String url = albumEntry.getFeedLink().getHref() + "?kind=photo";
//the albuFeed contains the album details
AlbumFeed feed = getService().getFeed(new URL(url), AlbumFeed.class);
//a photoEntry contains all photo infos including the urls to the thubnails and image data
List<PhotoEntry> photos = feed.getPhotoEntries();

Benutzung eines HTTP-Proxys

In Java lässt sich die Benutzung eines HTTP-Proxys für http/https Zugriffe wie folgt vornehmen:

Properties systemSettings = System.getProperties();
systemSettings.put("https.proxySet", "true");
systemSettings.put("http.proxyHost", proxyHost);
systemSettings.put("http.proxyPort", proxyPort);
systemSettings.put("proxySet", "true");
systemSettings.put("https.proxyHost", proxyHost);
systemSettings.put("https.proxyPort", proxyPort);
System.setProperties(systemSettings);

Http- und https-Zugriffe sollten nun die Proxy-Einstellungen berücksichtigen.

HTTP-Proxy-Authentifikation

Ggf. erfordert der HTTP-Proxy eine Authentifikation. Dabei ist für normale JAVA-Web Zugriffe Folgendes notwendig:

URL url = new URL(theUrl);
URLConnection conn = url.openConnection();
String encoded = getBas64EncodeCredentials(getProxyUser(), getProxyPasswd());
conn.setRequestProperty("Proxy-Authorization", "Basic " + encoded);
conn.connect();

Googles API kann ebenfalls mit einer Authentifizierung an einem HTTP-Proxy umgehen; dazu ist Folgendes setzen:

String base64encodedCredentials = "Basic " + getBas64EncodeCredentials(getProxyUser(), getProxyPasswd());
picasaService.getRequestFactory().setPrivateHeader("Proxy-Authorization", base64encodedCredentials);

Base64-codierte Credentials:

private String getBas64EncodeCredentials(String user, String passwd) {
	String userPasswd = user + ":" + passwd;
        String encoded = new String(Base64.encode(userPasswd.getBytes()));
        return encoded;
}

Most viszont úgy érzem eljött az a pillanat, amikor szépen letörlődik az a mocsadék és újra nekiállok. Folyt. köv.