examples.rb in twilio-ruby-3.3.1 vs examples.rb in twilio-ruby-3.4.0

@@ -5,30 +5,33 @@
 # set up a client, without any http requests
 @client = Twilio::REST::Client.new(@account_sid, @auth_token)
 
 ################ ACCOUNTS ################
 
-# grab an account instance resource (no http request)
+# shortcut to grab your account object (account_sid is inferred from the client's auth credentials)
+@account = @client.account 
+
+# list your (sub)accounts
[e-mail]
+
+# grab an account instance resource if you know the sid (no http request)
 @account = @client.accounts.get(@account_sid)
 # http round trip happens here
 puts @account.friendly_name
 
 # update an account's friendly name (only one http request, for the POST)
 @client.accounts.get(@account_sid).update(:friendly_name => 'A Fabulous Friendly Name')
 
-# shortcut to grab your account object (account_sid is inferred from the client's auth credentials)
-@account = @client.account 
-
 ################ CALLS ################
 
-# print a list of calls (all parameters optional, single http req)
+# print a list of calls (all parameters optional, single http request)
 @account.calls.list({:page => 0, :page_size => 1000, :start_time => '2010-09-01'}).each do |call|
   puts call.sid
 end
 
-# get a particular call and list its recordings (one http req, for each())
[e-mail]('CAXXXXXXX').recordings.list.each do {|r| puts r.sid}
+# get a particular call and list its recording urls (one http request for #list)
[e-mail]('CAXXXXXXX').recordings.list.each do {|r| puts r.wav}
 
 # make a new outgoing call (this is the same type of object we get
 # from calls.get, except this has attributes since we made an http request)
 @call = @account.calls.create({:from => '[phone]', :to => '[phone]', :url => 'http://myapp.com/call-handler'})
 
@@ -59,10 +62,10 @@
 # send an sms
 @account.sms.messages.create(:from => '[phone]', :to => '[phone]', :body => 'Hey there!')
 
 ################ PHONE NUMBERS ################
 
-# get a list of supported country codes (api currently doesn't support this)
+# get a list of supported country codes
 @account.available_phone_numbers.list
 
 # print some available numbers (only one http request)
 @numbers = @account.available_phone_numbers.get('US').local.list({:contains => 'AWESOME'})
 @numbers.each {|num| puts num.phone_number}