Starting to sketch out a blog post: everything you ever wanted to know about our new discovery-based APIs and libraries but you were afraid to ask.

Libraries:
https://code.google.com/apis/discovery/libraries.html which includes
http://code.google.com/p/google-api-python-client/
http://code.google.com/p/google-api-java-client/
http://code.google.com/p/google-api-ruby-client/
http://code.google.com/p/google-api-php-client/
http://code.google.com/p/google-api-dotnet-client/
http://code.google.com/p/gwt-google-apis/

The open source API Explorer:
http://code.google.com/apis/explorer/
http://code.google.com/p/google-apis-explorer/

Discovery Service:
http://googlecode.blogspot.com/2011/05/google-apis-discovery-service-one-api.html
https://plus.google.com/118148240205592032989/posts/GQBKCaLoyxV

Other people doing the same thing:
http://openwebfoo10.wiki.oreilly.com/wiki/index.php/Making_Web_APIs_Better

The wiki page for the OpenWebFoo session on API usability: http://openwebfoo10.wiki.oreilly.com/wiki/index.php/Making_APIs_useable

The discovery document for Buzz: https://www.googleapis.com/discovery/v1/apis/buzz/v1/rest

The core of the discovery library: http://code.google.com/p/google-api-python-client/source/browse/apiclient/discovery.py

The design document for the Python library: http://code.google.com/p/google-api-python-client/wiki/ClientDesignDocument

+Joe Gregorio +Monsur Hossain : on how to build a client library for your favourite language http://www.google.com/events/io/2011/sessions/building-custom-client-libraries-for-google-apis.html

Joe's questions about WADL: http://bitworking.org/news/193/Do-we-need-WADL

How OAuth2 and authentication works in the Python library: http://code.google.com/p/google-api-python-client/wiki/HowAuthenticationWorks

Other people can use our client libraries and discovery system to do cool stuff: http://blog.programmableweb.com/2011/06/27/new-try-it-feature-uses-google-discovery-api/

We chose JSON schema: http://json-schema.org/ rather than Orderly: http://orderly-json.org/

This: https://www.googleapis.com/discovery/v1/apis/plus/v1/rest is the ReSTful JSON-Schema discovery document for GPlus: https://www.googleapis.com/discovery/v1/apis/plus/v1/rest

This is the RPC version: https://www.googleapis.com/discovery/v1/apis/plus/v1/rpc

https://discovery-check.appspot.com/ by +Gerwin Sturm if you're interested in tracking changes to our discovery documents

====
This will get updated as I gather more information.

#posttoblog #discovery #googlediscovery   #forfutureme  #futureme
Shared publiclyView activity