twilio-ruby 5.25.4 → 5.26.0

data/lib/twilio-ruby/rest/wireless/v1/sim/data_session.rb

@@ -15,9 +15,9 @@ module Twilio
             ##
             # Initialize the DataSessionList
             # @param [Version] version Version that contains the resource
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Data Session is for.
+            # @param [String] sim_sid The SID of the [Sim
+            #   resource](https://www.twilio.com/docs/wireless/api/sim) that the Data Session is
+            #   for.
             # @return [DataSessionList] DataSessionList
             def initialize(version, sim_sid: nil)
               super(version)
@@ -31,8 +31,10 @@ module Twilio
             # Lists DataSessionInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
+            # @param [Time] end_ The date that the record ended, given as GMT in [ISO
+            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
+            # @param [Time] start The date that the Data Session started, given as GMT in [ISO
+            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -48,8 +50,10 @@ module Twilio
             # Streams DataSessionInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
+            # @param [Time] end_ The date that the record ended, given as GMT in [ISO
+            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
+            # @param [Time] start The date that the Data Session started, given as GMT in [ISO
+            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -82,8 +86,10 @@ module Twilio
             ##
             # Retrieve a single page of DataSessionInstance records from the API.
             # Request is executed immediately.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
+            # @param [Time] end_ The date that the record ended, given as GMT in [ISO
+            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
+            # @param [Time] start The date that the Data Session started, given as GMT in [ISO
+            #   8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
             # @param [Integer] page_size Number of records to return, defaults to 50
@@ -158,9 +164,9 @@ module Twilio
             # Initialize the DataSessionInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Data Session is for.
+            # @param [String] sim_sid The SID of the [Sim
+            #   resource](https://www.twilio.com/docs/wireless/api/sim) that the Data Session is
+            #   for.
             # @return [DataSessionInstance] DataSessionInstance
             def initialize(version, payload, sim_sid: nil)
               super(version)
@@ -187,97 +193,97 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique id of the Data Session resource that this Data Record is for.
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The unique id of the SIM resource that this Data Session is for.
+            # @return [String] The SID of the Sim resource that the Data Session is for
             def sim_sid
               @properties['sim_sid']
             end
 
             ##
-            # @return [String] The unique id of the Account that the SIM belongs to.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The generation of wireless technology that the device was attached to the cellular tower using.
+            # @return [String] The generation of wireless technology that the device was using
             def radio_link
               @properties['radio_link']
             end
 
             ##
-            # @return [String] The 'mobile country code' is the unique id of the home country where the Data Session took place.
+            # @return [String] The 'mobile country code' is the unique ID of the home country where the Data Session took place
             def operator_mcc
               @properties['operator_mcc']
             end
 
             ##
-            # @return [String] The 'mobile network code' is the unique id specific to the mobile operator network where the Data Session took place.
+            # @return [String] The 'mobile network code' is the unique ID specific to the mobile operator network where the Data Session took place
             def operator_mnc
               @properties['operator_mnc']
             end
 
             ##
-            # @return [String] The three letter country code representing where the device's Data Session took place.
+            # @return [String] The three letter country code representing where the device's Data Session took place
             def operator_country
               @properties['operator_country']
             end
 
             ##
-            # @return [String] The friendly name of the mobile operator network that the SIM-connected device is attached to.
+            # @return [String] The friendly name of the mobile operator network that the SIM-connected device is attached to
             def operator_name
               @properties['operator_name']
             end
 
             ##
-            # @return [String] The unique id of the cellular tower that the device was attached to at the moment when the Data Session was last updated.
+            # @return [String] The unique ID of the cellular tower that the device was attached to at the moment when the Data Session was last updated
             def cell_id
               @properties['cell_id']
             end
 
             ##
-            # @return [Hash] An object representing the estimated location where the device's Data Session took place.
+            # @return [Hash] An object with the estimated location where the device's Data Session took place
             def cell_location_estimate
               @properties['cell_location_estimate']
             end
 
             ##
-            # @return [String] The number of packets uploaded by the device between the start time and when the Data Session was last updated.
+            # @return [String] The number of packets uploaded by the device between the start time and when the Data Session was last updated
             def packets_uploaded
               @properties['packets_uploaded']
             end
 
             ##
-            # @return [String] The number of packets downloaded by the device between the start time and when the Data Session was last updated.
+            # @return [String] The number of packets downloaded by the device between the start time and when the Data Session was last updated
             def packets_downloaded
               @properties['packets_downloaded']
             end
 
             ##
-            # @return [Time] The date that this resource was last updated, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the resource was last updated, given as GMT in ISO 8601 format
             def last_updated
               @properties['last_updated']
             end
 
             ##
-            # @return [Time] The date that this Data Session started, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the Data Session started, given as GMT in ISO 8601 format
             def start
               @properties['start']
             end
 
             ##
-            # @return [Time] The date that this record ended, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the record ended, given as GMT in ISO 8601 format
             def end_
               @properties['end_']
             end
 
             ##
-            # @return [String] The unique id of the device using the SIM to connect.
+            # @return [String] The unique ID of the device using the SIM to connect
             def imei
               @properties['imei']
             end

data/lib/twilio-ruby/rest/wireless/v1/sim/usage_record.rb

@@ -15,9 +15,9 @@ module Twilio
             ##
             # Initialize the UsageRecordList
             # @param [Version] version Version that contains the resource
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Usage Record is for.
+            # @param [String] sim_sid The SID of the [Sim
+            #   resource](https://www.twilio.com/docs/wireless/api/sim) that this Usage Record
+            #   is for.
             # @return [UsageRecordList] UsageRecordList
             def initialize(version, sim_sid: nil)
               super(version)
@@ -31,13 +31,13 @@ module Twilio
             # Lists UsageRecordInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [Time] end_ Only include usage that has occurred on or before this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [Time] start Only include usage that has occurred on or after this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [usage_record.Granularity] granularity The time-based grouping that
-            #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-            #   return one Usage Record for the entire period.
+            # @param [Time] end_ Only include usage that occurred on or before this date,
+            #   specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+            # @param [Time] start Only include usage that has occurred on or after this date,
+            #   specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+            # @param [usage_record.Granularity] granularity How to summarize the usage by
+            #   time. Can be: `daily`, `hourly`, or `all`. A value of `all` returns one Usage
+            #   Record that describes the usage for the entire period.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -59,13 +59,13 @@ module Twilio
             # Streams UsageRecordInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [Time] end_ Only include usage that has occurred on or before this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [Time] start Only include usage that has occurred on or after this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [usage_record.Granularity] granularity The time-based grouping that
-            #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-            #   return one Usage Record for the entire period.
+            # @param [Time] end_ Only include usage that occurred on or before this date,
+            #   specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+            # @param [Time] start Only include usage that has occurred on or after this date,
+            #   specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+            # @param [usage_record.Granularity] granularity How to summarize the usage by
+            #   time. Can be: `daily`, `hourly`, or `all`. A value of `all` returns one Usage
+            #   Record that describes the usage for the entire period.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -98,13 +98,13 @@ module Twilio
             ##
             # Retrieve a single page of UsageRecordInstance records from the API.
             # Request is executed immediately.
-            # @param [Time] end_ Only include usage that has occurred on or before this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [Time] start Only include usage that has occurred on or after this date.
-            #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-            # @param [usage_record.Granularity] granularity The time-based grouping that
-            #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-            #   return one Usage Record for the entire period.
+            # @param [Time] end_ Only include usage that occurred on or before this date,
+            #   specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+            # @param [Time] start Only include usage that has occurred on or after this date,
+            #   specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+            # @param [usage_record.Granularity] granularity How to summarize the usage by
+            #   time. Can be: `daily`, `hourly`, or `all`. A value of `all` returns one Usage
+            #   Record that describes the usage for the entire period.
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
             # @param [Integer] page_size Number of records to return, defaults to 50
@@ -180,9 +180,9 @@ module Twilio
             # Initialize the UsageRecordInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Usage Record is for.
+            # @param [String] sim_sid The SID of the [Sim
+            #   resource](https://www.twilio.com/docs/wireless/api/sim) that this Usage Record
+            #   is for.
             # @return [UsageRecordInstance] UsageRecordInstance
             def initialize(version, payload, sim_sid: nil)
               super(version)
@@ -198,31 +198,31 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique id of the SIM resource that this Usage Record is for.
+            # @return [String] The SID of the Sim resource that this Usage Record is for
             def sim_sid
               @properties['sim_sid']
             end
 
             ##
-            # @return [String] The unique id of the Account that the SIM belongs to.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [Hash] The time period for which usage is reported.
+            # @return [Hash] The time period for which the usage is reported
             def period
               @properties['period']
             end
 
             ##
-            # @return [Hash] An object representing the Commands usage for the SIM over the period.
+            # @return [Hash] An object that describes the SIM's usage of Commands during the specified period
             def commands
               @properties['commands']
             end
 
             ##
-            # @return [Hash] An object representing the Data usage for the SIM over the period.
+            # @return [Hash] An object that describes the SIM's data usage during the specified period
             def data
               @properties['data']
             end

data/lib/twilio-ruby/rest/wireless/v1/usage_record.rb

@@ -28,12 +28,12 @@ module Twilio
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
           # @param [Time] end_ Only include usage that has occurred on or before this date.
-          #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
+          #   Format is [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
           # @param [Time] start Only include usage that has occurred on or after this date.
-          #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-          # @param [usage_record.Granularity] granularity The time-based grouping that
-          #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-          #   return one Usage Record for the entire period.
+          #   Format is [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+          # @param [usage_record.Granularity] granularity How to summarize the usage by
+          #   time. Can be: `daily`, `hourly`, or `all`. A value of `all` returns one Usage
+          #   Record that describes the usage for the entire period.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit.  Default is no limit
           # @param [Integer] page_size Number of records to fetch per request, when
@@ -56,12 +56,12 @@ module Twilio
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
           # @param [Time] end_ Only include usage that has occurred on or before this date.
-          #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
+          #   Format is [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
           # @param [Time] start Only include usage that has occurred on or after this date.
-          #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-          # @param [usage_record.Granularity] granularity The time-based grouping that
-          #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-          #   return one Usage Record for the entire period.
+          #   Format is [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+          # @param [usage_record.Granularity] granularity How to summarize the usage by
+          #   time. Can be: `daily`, `hourly`, or `all`. A value of `all` returns one Usage
+          #   Record that describes the usage for the entire period.
           # @param [Integer] limit Upper limit for the number of records to return. stream()
           #    guarantees to never return more than limit. Default is no limit.
           # @param [Integer] page_size Number of records to fetch per request, when
@@ -95,12 +95,12 @@ module Twilio
           # Retrieve a single page of UsageRecordInstance records from the API.
           # Request is executed immediately.
           # @param [Time] end_ Only include usage that has occurred on or before this date.
-          #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
+          #   Format is [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
           # @param [Time] start Only include usage that has occurred on or after this date.
-          #   Format is [ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm).
-          # @param [usage_record.Granularity] granularity The time-based grouping that
-          #   results are aggregated by. Valid values are `daily`, `hourly`, `all`. `all` will
-          #   return one Usage Record for the entire period.
+          #   Format is [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).
+          # @param [usage_record.Granularity] granularity How to summarize the usage by
+          #   time. Can be: `daily`, `hourly`, or `all`. A value of `all` returns one Usage
+          #   Record that describes the usage for the entire period.
           # @param [String] page_token PageToken provided by the API
           # @param [Integer] page_number Page Number, this value is simply for client state
           # @param [Integer] page_size Number of records to return, defaults to 50
@@ -190,25 +190,25 @@ module Twilio
           end
 
           ##
-          # @return [String] The unique id of the Account.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [Hash] The time period for which usage is reported.
+          # @return [Hash] The time period for which usage is reported
           def period
             @properties['period']
           end
 
           ##
-          # @return [Hash] An object representing the aggregated Commands usage for all SIMs over the period.
+          # @return [Hash] An object that describes the aggregated Commands usage for all SIMs during the specified period
           def commands
             @properties['commands']
           end
 
           ##
-          # @return [Hash] An object representing the aggregated Data usage for all SIMs over the period.
+          # @return [Hash] An object that describes the aggregated Data usage for all SIMs over the period
           def data
             @properties['data']
           end

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.25.4'
+    VERSION = '5.26.0'
 end

data/spec/integration/api/v2010/account/call_spec.rb

@@ -358,4 +358,49 @@ describe 'Call' do
 
     expect(actual).to_not eq(nil)
   end
+
+  it "receives posttwiml responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "annotation": null,
+          "answered_by": null,
+          "api_version": "2010-04-01",
+          "caller_name": null,
+          "date_created": "Tue, 31 Aug 2010 20:36:28 +0000",
+          "date_updated": "Tue, 31 Aug 2010 20:36:44 +0000",
+          "direction": "inbound",
+          "duration": "15",
+          "end_time": "Tue, 31 Aug 2010 20:36:44 +0000",
+          "forwarded_from": "+141586753093",
+          "from": "+14158675308",
+          "from_formatted": "(415) 867-5308",
+          "group_sid": null,
+          "parent_call_sid": null,
+          "phone_number_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "price": "-0.03000",
+          "price_unit": "USD",
+          "sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "start_time": "Tue, 31 Aug 2010 20:36:29 +0000",
+          "status": "canceled",
+          "subresource_uris": {
+              "notifications": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Notifications.json",
+              "recordings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings.json",
+              "feedback": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Feedback.json",
+              "feedback_summaries": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/FeedbackSummary.json"
+          },
+          "to": "+14158675309",
+          "to_formatted": "(415) 867-5309",
+          "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json"
+      }
+      ]
+    ))
+
+    actual = @client.api.v2010.accounts('ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                              .calls('CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').update()
+
+    expect(actual).to_not eq(nil)
+  end
 end

data/spec/integration/api/v2010/account/message_spec.rb

@@ -63,6 +63,43 @@ describe 'Message' do
     expect(actual).to_not eq(nil)
   end
 
+  it "receives create_wo_service responses" do
+    @holodeck.mock(Twilio::Response.new(
+        201,
+      %q[
+      {
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "api_version": "2010-04-01",
+          "body": "Hello! \ud83d\udc4d",
+          "date_created": "Thu, 30 Jul 2015 20:12:31 +0000",
+          "date_sent": "Thu, 30 Jul 2015 20:12:33 +0000",
+          "date_updated": "Thu, 30 Jul 2015 20:12:33 +0000",
+          "direction": "outbound-api",
+          "error_code": null,
+          "error_message": null,
+          "from": "+14155552345",
+          "messaging_service_sid": null,
+          "num_media": "0",
+          "num_segments": "1",
+          "price": "-0.00750",
+          "price_unit": "USD",
+          "sid": "SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "status": "sent",
+          "subresource_uris": {
+              "media": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Media.json"
+          },
+          "to": "+14155552345",
+          "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages/SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json"
+      }
+      ]
+    ))
+
+    actual = @client.api.v2010.accounts('ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                              .messages.create(to: '+15558675310')
+
+    expect(actual).to_not eq(nil)
+  end
+
   it "can delete" do
     @holodeck.mock(Twilio::Response.new(500, ''))