twilio-ruby 5.20.0 → 5.47.0

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -29,7 +29,13 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
+      # @return [Twilio::REST::Wireless::V1::UsageRecordInstance]
+      def usage_records
+        self.v1.usage_records()
+      end
+
+      ##
+      # @param [String] sid The unique string that we created to identify the Command
       #   resource.
       # @return [Twilio::REST::Wireless::V1::CommandInstance] if sid was passed.
       # @return [Twilio::REST::Wireless::V1::CommandList]
@@ -38,7 +44,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
+      # @param [String] sid The unique string that we created to identify the RatePlan
       #   resource.
       # @return [Twilio::REST::Wireless::V1::RatePlanInstance] if sid was passed.
       # @return [Twilio::REST::Wireless::V1::RatePlanList]
@@ -47,7 +53,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
+      # @param [String] sid The unique string that we created to identify the Sim
       #   resource.
       # @return [Twilio::REST::Wireless::V1::SimInstance] if sid was passed.
       # @return [Twilio::REST::Wireless::V1::SimList]

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -15,14 +15,20 @@ module Twilio
         def initialize(domain)
           super
           @version = 'v1'
+          @usage_records = nil
           @commands = nil
           @rate_plans = nil
           @sims = nil
         end
 
         ##
-        # @param [String] sid A 34 character string that uniquely identifies this
-        #   resource.
+        # @return [Twilio::REST::Wireless::V1::UsageRecordContext]
+        def usage_records
+          @usage_records ||= UsageRecordList.new self
+        end
+
+        ##
+        # @param [String] sid The SID of the Command resource to fetch.
         # @return [Twilio::REST::Wireless::V1::CommandContext] if sid was passed.
         # @return [Twilio::REST::Wireless::V1::CommandList]
         def commands(sid=:unset)
@@ -36,7 +42,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid The sid
+        # @param [String] sid The SID of the RatePlan resource to fetch.
         # @return [Twilio::REST::Wireless::V1::RatePlanContext] if sid was passed.
         # @return [Twilio::REST::Wireless::V1::RatePlanList]
         def rate_plans(sid=:unset)
@@ -50,8 +56,7 @@ module Twilio
         end
 
         ##
-        # @param [String] sid A 34 character string that uniquely identifies this
-        #   resource.
+        # @param [String] sid The SID or the `unique_name` of the Sim resource to fetch.
         # @return [Twilio::REST::Wireless::V1::SimContext] if sid was passed.
         # @return [Twilio::REST::Wireless::V1::SimList]
         def sims(sid=:unset)

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -27,12 +27,14 @@ module Twilio
           # Lists CommandInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
-          # @param [String] sim Only return Commands to or from this SIM.
-          # @param [command.Status] status Only return Commands with this status value.
+          # @param [String] sim The `sid` or `unique_name` of the {Sim
+          #   resources}[https://www.twilio.com/docs/wireless/api/sim-resource] to read.
+          # @param [command.Status] status The status of the resources to read. Can be:
+          #   `queued`, `sent`, `delivered`, `received`, or `failed`.
           # @param [command.Direction] direction Only return Commands with this direction
           #   value.
           # @param [command.Transport] transport Only return Commands with this transport
-          #   value.
+          #   value. Can be: `sms` or `ip`.
           # @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
@@ -55,12 +57,14 @@ module Twilio
           # Streams CommandInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
-          # @param [String] sim Only return Commands to or from this SIM.
-          # @param [command.Status] status Only return Commands with this status value.
+          # @param [String] sim The `sid` or `unique_name` of the {Sim
+          #   resources}[https://www.twilio.com/docs/wireless/api/sim-resource] to read.
+          # @param [command.Status] status The status of the resources to read. Can be:
+          #   `queued`, `sent`, `delivered`, `received`, or `failed`.
           # @param [command.Direction] direction Only return Commands with this direction
           #   value.
           # @param [command.Transport] transport Only return Commands with this transport
-          #   value.
+          #   value. Can be: `sms` or `ip`.
           # @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
@@ -99,12 +103,14 @@ module Twilio
           ##
           # Retrieve a single page of CommandInstance records from the API.
           # Request is executed immediately.
-          # @param [String] sim Only return Commands to or from this SIM.
-          # @param [command.Status] status Only return Commands with this status value.
+          # @param [String] sim The `sid` or `unique_name` of the {Sim
+          #   resources}[https://www.twilio.com/docs/wireless/api/sim-resource] to read.
+          # @param [command.Status] status The status of the resources to read. Can be:
+          #   `queued`, `sent`, `delivered`, `received`, or `failed`.
           # @param [command.Direction] direction Only return Commands with this direction
           #   value.
           # @param [command.Transport] transport Only return Commands with this transport
-          #   value.
+          #   value. Can be: `sms` or `ip`.
           # @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
@@ -119,11 +125,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             CommandPage.new(@version, response, @solution)
           end
 
@@ -141,34 +145,32 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of CommandInstance records from the API.
-          # Request is executed immediately.
-          # @param [String] command The message body of the Command (in text mode) or a
-          #   Base64 encoded byte string in binary mode.
-          # @param [String] sim The Sid or UniqueName of the
-          #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) to send the Command
+          # Create the CommandInstance
+          # @param [String] command The message body of the Command. Can be plain text in
+          #   text mode or a Base64 encoded byte string in binary mode.
+          # @param [String] sim The `sid` or `unique_name` of the
+          #   {SIM}[https://www.twilio.com/docs/wireless/api/sim-resource] to send the Command
           #   to.
-          # @param [String] callback_method The HTTP method Twilio will use when making a
-          #   request to the callback URL (valid options are GET or POST). Defaults to POST.
-          # @param [String] callback_url Twilio will make a request to this URL when the
-          #   Command has finished sending (delivered or failed).
-          # @param [command.CommandMode] command_mode A string representing which mode to
-          #   send the SMS message using. May be `text` or `binary`. If omitted, the default
-          #   SMS mode is `text`.
-          # @param [String] include_sid When sending a Command to a SIM in text mode, Twilio
-          #   can automatically include the Sid of the Command in the message body, which
-          #   could be used to ensure that the device does not process the same Command more
-          #   than once. The options for inclusion are `none`, `start` and `end`. The default
-          #   behavior is `none`. When using `start` or `end`, the CommandSid will be
-          #   prepended or appended to the message body, with a space character separating the
-          #   CommandSid and the message body. The length of the CommandSid contributes toward
-          #   the 160 character limit, i.e. the SMS body must be 128 characters or less before
-          #   the Command Sid is included.
-          # @param [Boolean] delivery_receipt_requested A boolean representing whether to
-          #   request delivery receipt from the recipient. For Commands that request delivery
-          #   receipt, the Command state transitions to 'delivered' once the server has
-          #   received a delivery receipt from the device. Defaults to true.
-          # @return [CommandInstance] Newly created CommandInstance
+          # @param [String] callback_method The HTTP method we use to call `callback_url`.
+          #   Can be: `POST` or `GET`, and the default is `POST`.
+          # @param [String] callback_url The URL we call using the `callback_url` when the
+          #   Command has finished sending, whether the command was delivered or it failed.
+          # @param [command.CommandMode] command_mode The mode to use when sending the SMS
+          #   message. Can be: `text` or `binary`. The default SMS mode is `text`.
+          # @param [String] include_sid Whether to include the SID of the command in the
+          #   message body. Can be: `none`, `start`, or `end`, and the default behavior is
+          #   `none`. When sending a Command to a SIM in text mode, we can automatically
+          #   include the SID of the Command in the message body, which could be used to
+          #   ensure that the device does not process the same Command more than once.  A
+          #   value of `start` will prepend the message with the Command SID, and `end` will
+          #   append it to the end, separating the Command SID from the message body with a
+          #   space. The length of the Command SID is included in the 160 character limit so
+          #   the SMS body must be 128 characters or less before the Command SID is included.
+          # @param [Boolean] delivery_receipt_requested Whether to request delivery receipt
+          #   from the recipient. For Commands that request delivery receipt, the Command
+          #   state transitions to 'delivered' once the server has received a delivery receipt
+          #   from the device. The default value is `true`.
+          # @return [CommandInstance] Created CommandInstance
           def create(command: nil, sim: :unset, callback_method: :unset, callback_url: :unset, command_mode: :unset, include_sid: :unset, delivery_receipt_requested: :unset)
             data = Twilio::Values.of({
                 'Command' => command,
@@ -180,11 +182,7 @@ module Twilio
                 'DeliveryReceiptRequested' => delivery_receipt_requested,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             CommandInstance.new(@version, payload, )
           end
@@ -229,8 +227,7 @@ module Twilio
           ##
           # Initialize the CommandContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid A 34 character string that uniquely identifies this
-          #   resource.
+          # @param [String] sid The SID of the Command resource to fetch.
           # @return [CommandContext] CommandContext
           def initialize(version, sid)
             super(version)
@@ -241,25 +238,19 @@ module Twilio
           end
 
           ##
-          # Fetch a CommandInstance
+          # Fetch the CommandInstance
           # @return [CommandInstance] Fetched CommandInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             CommandInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the CommandInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the CommandInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -268,6 +259,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Wireless.V1.CommandContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Wireless.V1.CommandContext #{context}>"
+          end
         end
 
         class CommandInstance < InstanceResource
@@ -275,8 +273,7 @@ module Twilio
           # Initialize the CommandInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid A 34 character string that uniquely identifies this
-          #   resource.
+          # @param [String] sid The SID of the Command resource to fetch.
           # @return [CommandInstance] CommandInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -314,87 +311,87 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this resource.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] The unique id of the Account that this Command belongs to.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] The unique ID of the SIM that this Command was sent to or from.
+          # @return [String] The SID of the Sim resource that the Command was sent to or from
           def sim_sid
             @properties['sim_sid']
           end
 
           ##
-          # @return [String] The message being sent to or from the SIM.
+          # @return [String] The message being sent to or from the SIM
           def command
             @properties['command']
           end
 
           ##
-          # @return [command.CommandMode] A string representing which mode the SMS was sent or received using.
+          # @return [command.CommandMode] The mode used to send the SMS message
           def command_mode
             @properties['command_mode']
           end
 
           ##
-          # @return [command.Transport] The transport
+          # @return [command.Transport] The type of transport used
           def transport
             @properties['transport']
           end
 
           ##
-          # @return [Boolean] The delivery_receipt_requested
+          # @return [Boolean] Whether to request a delivery receipt
           def delivery_receipt_requested
             @properties['delivery_receipt_requested']
           end
 
           ##
-          # @return [command.Status] A string representing the status of the Command.
+          # @return [command.Status] The status of the Command
           def status
             @properties['status']
           end
 
           ##
-          # @return [command.Direction] The direction of the Command.
+          # @return [command.Direction] The direction of the Command
           def direction
             @properties['direction']
           end
 
           ##
-          # @return [Time] The date that this resource was created, given as GMT in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was created
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date that this resource was last updated, given as GMT in ISO 8601 format.
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated format
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The URL for this resource.
+          # @return [String] The absolute URL of the resource
           def url
             @properties['url']
           end
 
           ##
-          # Fetch a CommandInstance
+          # Fetch the CommandInstance
           # @return [CommandInstance] Fetched CommandInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Deletes the CommandInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the CommandInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete
           end

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

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -84,11 +84,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             RatePlanPage.new(@version, response, @solution)
           end
 
@@ -106,38 +104,43 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of RatePlanInstance records from the API.
-          # Request is executed immediately.
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the Sid.
-          # @param [String] friendly_name A user-provided string that identifies this
-          #   resource. Non-unique.
-          # @param [Boolean] data_enabled Defines whether SIMs are capable of using
-          #   GPRS/3G/LTE data connectivity.
-          # @param [String] data_limit Network-enforced limit specifying the total Megabytes
-          #   of data usage (download and upload combined) allowed during one month on the
-          #   home network. Metering begins on the day of activation and ends on the same day
-          #   of the following month.  Max value is 2TB.
-          # @param [String] data_metering The model by which to meter data usage, in
-          #   accordance with the two available [data metering
-          #   models](https://www.twilio.com/docs/api/wireless/rest-api/rate-plan#explanation-of-pooled-vs-individual). Valid options are `pooled` and `individual`.
-          # @param [Boolean] messaging_enabled Defines whether SIMs are capable of making
-          #   and sending and receiving SMS messages via either
-          #   [Commands](https://www.twilio.com/docs/wireless/api/commands) or Programmable
-          #   SMS APIs.
-          # @param [Boolean] voice_enabled Defines whether SIMs are capable of making and
-          #   receiving voice calls.
-          # @param [Boolean] national_roaming_enabled Defines whether SIMs can roam onto
-          #   other networks in the SIM's home country. See ['national'
-          #   roaming](https://www.twilio.com/docs/api/wireless/rest-api/rate-plan#national-roaming).
-          # @param [String] international_roaming The international_roaming
-          # @param [String] national_roaming_data_limit Network-enforced limit specifying
-          #   the total Megabytes of national roaming data usage (download and upload
-          #   combined) allowed during one month.  Max value is 2TB. If unspecified, the
-          #   default value is the lesser of `DataLimit` and 1000MB.
-          # @param [String] international_roaming_data_limit The
-          #   international_roaming_data_limit
-          # @return [RatePlanInstance] Newly created RatePlanInstance
+          # Create the RatePlanInstance
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used in place of the resource's `sid` in the
+          #   URL to address the resource.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It does not have to be unique.
+          # @param [Boolean] data_enabled Whether SIMs can use GPRS/3G/4G/LTE data
+          #   connectivity.
+          # @param [String] data_limit The total data usage (download and upload combined)
+          #   in Megabytes that the Network allows during one month on the home network
+          #   (T-Mobile USA). The metering period begins the day of activation and ends on the
+          #   same day in the following month. Can be up to 2TB and the default value is
+          #   `1000`.
+          # @param [String] data_metering The model used to meter data usage. Can be: `payg`
+          #   and `quota-1`, `quota-10`, and `quota-50`. Learn more about the available {data
+          #   metering
+          #   models}[https://www.twilio.com/docs/wireless/api/rateplan-resource#payg-vs-quota-data-plans].
+          # @param [Boolean] messaging_enabled Whether SIMs can make, send, and receive SMS
+          #   using {Commands}[https://www.twilio.com/docs/wireless/api/command-resource].
+          # @param [Boolean] voice_enabled Whether SIMs can make and receive voice calls.
+          # @param [Boolean] national_roaming_enabled Whether SIMs can roam on networks
+          #   other than the home network (T-Mobile USA) in the United States. See {national
+          #   roaming}[https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming].
+          # @param [Array[String]] international_roaming The list of services that SIMs
+          #   capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United
+          #   States. Can be: `data`, `voice`, and `messaging`.
+          # @param [String] national_roaming_data_limit The total data usage (download and
+          #   upload combined) in Megabytes that the Network allows during one month on
+          #   non-home networks in the United States. The metering period begins the day of
+          #   activation and ends on the same day in the following month. Can be up to 2TB.
+          #   See {national
+          #   roaming}[https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming]
+          #   for more info.
+          # @param [String] international_roaming_data_limit The total data usage (download
+          #   and upload combined) in Megabytes that the Network allows during one month when
+          #   roaming outside the United States. Can be up to 2TB.
+          # @return [RatePlanInstance] Created RatePlanInstance
           def create(unique_name: :unset, friendly_name: :unset, data_enabled: :unset, data_limit: :unset, data_metering: :unset, messaging_enabled: :unset, voice_enabled: :unset, national_roaming_enabled: :unset, international_roaming: :unset, national_roaming_data_limit: :unset, international_roaming_data_limit: :unset)
             data = Twilio::Values.of({
                 'UniqueName' => unique_name,
@@ -153,11 +156,7 @@ module Twilio
                 'InternationalRoamingDataLimit' => international_roaming_data_limit,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             RatePlanInstance.new(@version, payload, )
           end
@@ -202,7 +201,7 @@ module Twilio
           ##
           # Initialize the RatePlanContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the RatePlan resource to fetch.
           # @return [RatePlanContext] RatePlanContext
           def initialize(version, sid)
             super(version)
@@ -213,44 +212,35 @@ module Twilio
           end
 
           ##
-          # Fetch a RatePlanInstance
+          # Fetch the RatePlanInstance
           # @return [RatePlanInstance] Fetched RatePlanInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             RatePlanInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
           # Update the RatePlanInstance
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the Sid.
-          # @param [String] friendly_name A user-provided string that identifies this
-          #   resource. Non-unique.
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used in place of the resource's `sid` in the
+          #   URL to address the resource.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It does not have to be unique.
           # @return [RatePlanInstance] Updated RatePlanInstance
           def update(unique_name: :unset, friendly_name: :unset)
             data = Twilio::Values.of({'UniqueName' => unique_name, 'FriendlyName' => friendly_name, })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             RatePlanInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the RatePlanInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the RatePlanInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -259,6 +249,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Wireless.V1.RatePlanContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Wireless.V1.RatePlanContext #{context}>"
+          end
         end
 
         class RatePlanInstance < InstanceResource
@@ -266,7 +263,7 @@ module Twilio
           # Initialize the RatePlanInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the RatePlan resource to fetch.
           # @return [RatePlanInstance] RatePlanInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -308,103 +305,103 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this resource.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] A user-provided string that uniquely identifies this resource as an alternative to the sid.
+          # @return [String] An application-defined string that uniquely identifies the resource
           def unique_name
             @properties['unique_name']
           end
 
           ##
-          # @return [String] The unique id of the Account that this Rate Plan belongs to.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] A user-provided string that identifies this resource.
+          # @return [String] The string that you assigned to describe the resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [Boolean] Defines whether SIMs are capable of using GPRS/3G/4G/LTE data connectivity.
+          # @return [Boolean] Whether SIMs can use GPRS/3G/4G/LTE data connectivity
           def data_enabled
             @properties['data_enabled']
           end
 
           ##
-          # @return [String] The model by which to meter data usage, in accordance with the two available data metering models.
+          # @return [String] The model used to meter data usage
           def data_metering
             @properties['data_metering']
           end
 
           ##
-          # @return [String] Network-enforced limit specifying the total Megabytes of data usage allowed during one month on the home network.
+          # @return [String] The total data usage in Megabytes that the Network allows during one month on the home network
           def data_limit
             @properties['data_limit']
           end
 
           ##
-          # @return [Boolean] Defines whether SIMs are capable of making and sending and receiving SMS via Commands.
+          # @return [Boolean] Whether SIMs can make, send, and receive SMS using Commands
           def messaging_enabled
             @properties['messaging_enabled']
           end
 
           ##
-          # @return [Boolean] Defines whether SIMs are capable of making and receiving voice calls.
+          # @return [Boolean] Whether SIMs can make and receive voice calls
           def voice_enabled
             @properties['voice_enabled']
           end
 
           ##
-          # @return [Boolean] Defines whether SIMs can roam onto other networks in the SIM's home country.
+          # @return [Boolean] Whether SIMs can roam on networks other than the home network in the United States
           def national_roaming_enabled
             @properties['national_roaming_enabled']
           end
 
           ##
-          # @return [String] Network-enforced limit specifying the total Megabytes of national roaming data usage allowed during one month.
+          # @return [String] The total data usage in Megabytes that the Network allows during one month on non-home networks in the United States
           def national_roaming_data_limit
             @properties['national_roaming_data_limit']
           end
 
           ##
-          # @return [String] The international_roaming
+          # @return [Array[String]] The services that SIMs capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United States
           def international_roaming
             @properties['international_roaming']
           end
 
           ##
-          # @return [String] The international_roaming_data_limit
+          # @return [String] The total data usage (download and upload combined) in Megabytes that the Network allows during one month when roaming outside the United States
           def international_roaming_data_limit
             @properties['international_roaming_data_limit']
           end
 
           ##
-          # @return [Time] The date that this resource was created, given as GMT in ISO 8601 format.
+          # @return [Time] The date when the resource was created, given as GMT in ISO 8601 format
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date that this resource was last updated, given as GMT in ISO 8601 format.
+          # @return [Time] The date when the resource was last updated, given as GMT in ISO 8601 format
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The URL for this resource.
+          # @return [String] The absolute URL of the resource
           def url
             @properties['url']
           end
 
           ##
-          # Fetch a RatePlanInstance
+          # Fetch the RatePlanInstance
           # @return [RatePlanInstance] Fetched RatePlanInstance
           def fetch
             context.fetch
@@ -412,18 +409,19 @@ module Twilio
 
           ##
           # Update the RatePlanInstance
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the Sid.
-          # @param [String] friendly_name A user-provided string that identifies this
-          #   resource. Non-unique.
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used in place of the resource's `sid` in the
+          #   URL to address the resource.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It does not have to be unique.
           # @return [RatePlanInstance] Updated RatePlanInstance
           def update(unique_name: :unset, friendly_name: :unset)
             context.update(unique_name: unique_name, friendly_name: friendly_name, )
           end
 
           ##
-          # Deletes the RatePlanInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the RatePlanInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete
           end