How the technologies behind Google Buzz are powering the wider social web and the impact of Developer Experience on the design of our discovery-based APIs.

1. Powering the Social Web
Discovery & Developer Experience
1

2. @adewale
buzz.google.com/adewale
@ade_oshineye
twitter.com/ade_oshineye

3. The plug

4. 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
4

5. Outline
1 The technologies behind the Buzz API
2 Discovery
3 Developer Experience
4 The web is the platform
5

6. Buzz & the open technologies behind it
6

7. 7

8. 8

9. Screenshots from: http://www.go-buzz.com/
9

12. Passwords are bad for everyone

14. OAuth
Your Service
Application Get unauthorized Provider
request token
1. Your application gets an unauthorized request token
from the Service Provider’s authorization server.

15. OAuth
Your Service
Application Provider
Send user to SP
with token
2. Your application sends the user to the Service
Provider, which asks the user to grant your
application access to the required data.

16. OAuth
Your Service
Application Get authorized Provider
request token
3. Your application gets an authorized request token
from the authorization server.

17. OAuth
Your Service
Application Exchange request Provider
for access token
4. You exchange the authorized request token for an
access token.

18. OAuth
Your Service
Application Use access token Provider
to get data
5. You use the access token to request data from
Service Provider’s service access servers.

19. Auth url: https://www.google.com/buzz/api/auth/OAuthAuthorizeToken
https://www.google.com/buzz/api/auth/OAuthAuthorizeToken
scope: https://www.googleapis.com/auth/buzz
?scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fbuzz
domain: www.example.org
&domain=www.example.org
iconUrl: http://www.example.org/icon.png
&oauth_token=

22. Polling is bad for everyone

23. code.google.com/p/pubsubhubbub

24. PubSubHubbub
Publisher Hub Subscriber

25. PubSubHubbub
Give me your
latest content for
feed X, please.
Publisher Subscriber
1. Subscriber gets Publisher’s feed. The feed contains
a link to the Hub.

26. PubSubHubbub
I've delegated
distribution of that content
to this Hub.
Publisher Subscriber
1. Subscriber gets Publisher’s feed. The feed contains
a link to the Hub.

27. PubSubHubbub
I want to
subscribe to feed X.
Send updates to this
URL
Publisher Hub Subscriber
2. Subscriber POSTs subscription request to the Hub.
The request contains the URL where the Hub should
POST new updates to the Subscriber.

28. PubSubHubbub
Hey there! Did
you really send this
request?
Publisher Hub Subscriber
3. Hub hits the URL to verify the request was authentic;
Subscriber responds with confirmation to the Hub.

29. PubSubHubbub
Yup, that was
really me, not a DoS
attacker.
Publisher Hub Subscriber
3. Hub hits the URL to verify the request was authentic;
Subscriber responds with confirmation to the Hub.

30. PubSubHubbub
I have new
content for feed X
for you!
Publisher Hub Subscriber
4. a) Publisher notifies Hub about updates by POSTing
feed URLs to the Hub; Hub pulls the feed again to
find new entries.

31. PubSubHubbub
Give me your
latest content for
feed X, please.
Publisher Hub Subscriber
4. a) Publisher notifies Hub about updates by POSTing
feed URLs to the Hub; Hub pulls the feed again to
find new entries.

32. PubSubHubbub
Here you go.
Publisher Hub Subscriber
4. a) Publisher notifies Hub about updates by POSTing
feed URLs to the Hub; Hub pulls the feed again to
find new entries.

33. PubSubHubbub
Give me your
latest content for
feed X, please.
Publisher Hub Subscriber
4. b) If the Publisher does not inform the Hub, the Hub
will periodically poll the Publisher’s feed for new
updates.

34. PubSubHubbub
Here you go.
Publisher Hub Subscriber
4. b) If the Publisher does not inform the Hub, the Hub
will periodically poll the Publisher’s feed for new
updates.

35. PubSubHubbub
New update to
feed X! Here you
go.
Publisher Hub Subscriber
5. When Hub receives new update to feed X, it POSTs
the update to the Subscriber’s endpoint URL.

36. PubSubHubbub
New update to
feed X! Here you
go.
Publisher Hub Subscriber
Subscriber
Subscriber
Subscriber
Subscriber
Subscriber
6. If feed X has multiple subscribers, the Hub sends
updates to all of them. This reduces load on the
Publisher.

37. PubSubHubbub

38. Firehose

39. Photo credit: Nandhp, used under the Creative Commons Attribution-Share Alike 3.0 Unported license.
Gardenhose

40. Track

41. Discovery
41

42. What is discovery?
42

43. Discovery document
goo.gl/Yy7XD
43

44. Easier to code
44

45. Easier migration
AuthSub to OAuth1
OAuth1 to OAuth2
45

46. One management console
46

47. Discovery-based libraries
code.google.com/p/google-api-php-client/
code.google.com/p/google-api-python-client/
code.google.com/p/google-api-java-client/
code.google.com/p/google-api-ruby-client

47

48. Missing languages?
48

49. Benefits
1 Latest features are instantly available to every language
2 More languages are supported by more APIs
3 APIs console gives you centralised management
4 Easier to use multiple APIs in the same project
49

50. What is #devexp?
Green
50

51. #devexp
developerexperience.org
51

52. Developer Experience
1 Apply UX techniques to developer-facing products
2 Focus on the 15 minute OOB experience
3 Use convention over configuration
4 Design away common problems
52

53. The web is the platform
53

54. Our platform is open to
extension, adaptation
and disruptive creativity
54

55. Discovery is the future
55

56. 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
56

57. The web is the platform
57

58. Thank You!
Q&A
58