This document discusses Google's developer experience and API discovery efforts. It introduces concepts like developer experience, discovery documents, code generation from discovery, and OAuth2 integration. Google aims to improve the out-of-box experience for developers through techniques like convention over configuration, addressing common problems rather than documenting workarounds, and providing discovery documents, client libraries and interactive API explorers to make APIs more accessible.

1. Google, Developer Experience and
Discovery
1

2. @adewale
www.oshineye.com/+
@ade_oshineye

4. The plug

5. Past
4

6. Google’s mission
To organize the world’s information and make
it universally accessible and useful.
Online content Offline content
Billions of web pages Billions of items
becoming indexed
5

7. Alerts Blogger Blog Search Book Search Buzz Calendar Checkout Code
Docs & Feedburner Froogle Gmail Google Labs
Directory Earth Finance
Spreadsheets
Google Reader Groups Images Local Maps Maps for Mobile Mobile News
Pack Picasa Scholar Talk Toolbar Translate SketchUp SMS
Specialized Video Web Accelerator Web Search YouTube
Searches
6

8. How do people feel about GData?
http://blog.bolinfest.com/2011/05/gdata-i-cant-take-it-anymore.html 7

9. Present
8

10. developerexperience.org
9
http://www.flickr.com/photos/adewale_oshineye/4043310805

11. What is Developer Experience?
1 Apply UX techniques to developer-facing products.
2 Focus on the out-of-box experience.
3 Use convention over configuration.
4 Design away common problems. Don’t document workarounds.
10

12. Caveats?
Old wine. New bottles.
Aspirational
11

13. Join us
developerexperience.org
@devexpftw
#devexp
12

14. Future
13

15. Problems with GData?
Library drift
Atom + APP
Low usability
High start-up costs
14

16. What is Discovery?
API description
Client-side introspection
Generated libraries 15

17. Discovery
JSONification
Discovery document
Default data format
Schema
16

18. Discovery document
https://www.googleapis.com/discovery/v1/apis/buzz/v1/rest 17

19. Code sample: Buzz
http://code.google.com/p/google-api-python-client/source/browse/samples/buzz/buzz.py 18

20. OAuth2
19

21. OAuth2 made simple
http://code.google.com/p/google-api-python-client/source/browse/samples/appengine_with_decorator/main.py 20

22. Client libraries for more languages
21

23. Interactive API Explorer
22

24. Unified APIs Console
23

25. Why should you care?
1 Better #devexp
2 More libraries for more languages
3 Other people can play
4 Easier and faster development
24

26. Thank You!
Questions?
25