Module buzz

source code

Common Tasks

• Authentication
  • Google's implementation of OAuth is covered in the documentation for the Accounts API: http://code.google.com/apis/accounts/docs/OAuth_ref.html
  • Getting the request token:

     import buzz
     client = buzz.Client()
     client.build_oauth_consumer('your-app.appspot.com', 'consumer_secret')
     client.oauth_scopes.append(buzz.FULL_ACCESS_SCOPE)
     request_token = \
       client.fetch_oauth_request_token('http://example.com/callback/')
     # Persist the request_token
     authorization_url = client.build_oauth_authorization_url()
     self.redirect(authorization_url)
    

  • Exchanging a request token for an access token:

     import buzz
     client = buzz.Client()
     client.build_oauth_consumer('your-app.appspot.com', 'consumer_secret')
     client.oauth_scopes.append(buzz.FULL_ACCESS_SCOPE)
     # Retrieve the persisted request token
     client.build_oauth_request_token(
       request_token.key, request_token.secret
     )
     verifier = self.request.get('oauth_verifier')
     access_token = \
       client.fetch_oauth_access_token(verifier)
     # Persist the access_token
    

  • Reusing an access token:

     import buzz
     client = buzz.Client()
     client.build_oauth_consumer('your-app.appspot.com', 'consumer_secret')
     client.oauth_scopes.append(buzz.FULL_ACCESS_SCOPE)
     # Retrieve the persisted access token
     client.build_oauth_access_token(
       access_token.key, access_token.secret
     )
    

• Getting streams
  • Signed-in user's consumption stream:

     results = client.posts(user_id='@me', type_id='@consumption')
    

  • Signed-in user's published posts:

     results = client.posts(user_id='@me', type_id='@self')
    

  • Another user's public posts:

     results = client.posts(user_id='googlebuzz', type_id='@public')
    

  • Larger result pages:

     results = client.posts(
       user_id='googlebuzz', type_id='@public', max_results=100
     )
    

• Creating a post
  • Simple:

     post = buzz.Post(
       content="This is some example content."
     )
     client.create_post(post)
    

  • Post with a link:

     attachment = buzz.Attachment(
       type='article',
       title='Google Buzz',
       uri='http://www.google.com/buzz'
     )
     post = buzz.Post(
       content="Google Buzz is really cool.",
       attachments=[attachment]
     )
     client.create_post(post)
    

  • Post with a geocode:

     post = buzz.Post(
       content="Google Buzz is really cool.",
       geocode=('37.421776', '-122.084155')
     )
     client.create_post(post)