twilio-ruby 5.19.0 → 5.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe045a2e772454c9b888039ad8140d8f4645ce87756e12c09024d2f7b65c3cd2
-  data.tar.gz: e74ff7b452249e730a32e5fcc2d419d7157b71db0519e3822d8175509cec6a19
+  metadata.gz: d696fcc08e99ee209986f64339d7d82383d1a7c04d005d1790b4354bd1186f3f
+  data.tar.gz: ea658e24b07d166708937e8736bb5f93d8e8dd06767a9d6811bca5de43d77aa9
 SHA512:
-  metadata.gz: c9734374ce684115310150d8aa8ee367a3704628cdfeedcb421264f90df53b9330642ad0c8c612ff6eec712aedfba2bd46cc5464cba8d4e9dcde0d93cff1b7ae
-  data.tar.gz: 9e4cea3ca89dbc6634330b1d0797d870b53f92b3bc3c834e08436a5b3cada6e45d541041bd22f6ae70257f69edc0a5df3c2bbc24d14d1c94a8d90c764246b0a5
+  metadata.gz: 8e42778969740cf63511ebf67aa90d80506efae04f57a72ea53664814eb8122c96c7ff59a342b746b4b3b5e389e2d8a697e7395b131dc8cf6a17eb53adfcc548
+  data.tar.gz: ec0e3e0af4928521451f92f36341a3e2654cd7842bacb496dda8a1b6b5bfa1282003c3cad8e8b46a254d6d7dcfcb33bb8a46b91c1ad28d6559fe1e3ed6b7eb52

data/CHANGES.md

@@ -1,6 +1,19 @@
 twilio-ruby changelog
 =====================
 
+[2019-02-04] Version 5.20.0
+----------------------------
+**Library**
+- PR #437: Switch body validator to use hex instead of base64. Thanks to @cjcodes!
+
+**Video**
+- [Recordings] Add media type filter to list operation
+- [Composer] Filter Composition Hook resources by FriendlyName
+
+**Twiml**
+- Update `language` enum for `Gather` to fix language code for Filipino (Philippines) and include additional supported languages **(breaking change)**
+
+
 [2019-01-11] Version 5.19.0
 ----------------------------
 **Library**

data/README.md

@@ -27,13 +27,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.19.0'
+gem 'twilio-ruby', '~> 5.20.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.19.0
+gem install twilio-ruby -v 5.20.0
 ```
 
 To build and install the development branch yourself from the latest source:

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

@@ -44,7 +44,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this address.
+      # @param [String] sid The unique string that that we created to identify the
+      #   Address resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::AddressInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::AddressList]
       def addresses(sid=:unset)
@@ -52,8 +53,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   resource.
+      # @param [String] sid The unique string that that we created to identify the
+      #   Application resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::ApplicationInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::ApplicationList]
       def applications(sid=:unset)
@@ -61,8 +62,7 @@ module Twilio
       end
 
       ##
-      # @param [String] connect_app_sid The unique id of the Connect App that was
-      #   authorized.
+      # @param [String] connect_app_sid The SID that we assigned to the Connect App.
       # @return [Twilio::REST::Api::V2010::AccountContext::AuthorizedConnectAppInstance] if connect_app_sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::AuthorizedConnectAppList]
       def authorized_connect_apps(connect_app_sid=:unset)
@@ -70,7 +70,9 @@ module Twilio
       end
 
       ##
-      # @param [String] country_code The ISO Country code to lookup phone numbers for.
+      # @param [String] country_code The
+      #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+      #   the country.
       # @return [Twilio::REST::Api::V2010::AccountContext::AvailablePhoneNumberCountryInstance] if country_code was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::AvailablePhoneNumberCountryList]
       def available_phone_numbers(country_code=:unset)
@@ -102,7 +104,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The unique id of this Connect App.
+      # @param [String] sid The unique string that that we created to identify the
+      #   ConnectApp resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::ConnectAppInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::ConnectAppList]
       def connect_apps(sid=:unset)
@@ -110,8 +113,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   resource.
+      # @param [String] sid The unique string that that we created to identify this
+      #   IncomingPhoneNumber resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::IncomingPhoneNumberInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::IncomingPhoneNumberList]
       def incoming_phone_numbers(sid=:unset)
@@ -149,8 +152,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   resource.
+      # @param [String] sid The unique string that that we created to identify the
+      #   Notification resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::NotificationInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::NotificationList]
       def notifications(sid=:unset)
@@ -158,8 +161,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this
-      #   resource.
+      # @param [String] sid The unique string that that we created to identify the
+      #   OutgoingCallerId resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::OutgoingCallerIdInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::OutgoingCallerIdList]
       def outgoing_caller_ids(sid=:unset)

data/lib/twilio-ruby/rest/api/v2010/account/address.rb

@@ -15,9 +15,9 @@ module Twilio
             ##
             # Initialize the AddressList
             # @param [Version] version Version that contains the resource
-            # @param [String] account_sid The unique id of the
-            #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
-            #   address.
+            # @param [String] account_sid The SID of the
+            #   [Account](https://www.twilio.com/docs/api/rest/account) that is responsible for
+            #   the Address resource.
             # @return [AddressList] AddressList
             def initialize(version, account_sid: nil)
               super(version)
@@ -30,24 +30,20 @@ module Twilio
             ##
             # Retrieve a single page of AddressInstance records from the API.
             # Request is executed immediately.
-            # @param [String] customer_name Your name or business name, or that of your
-            #   customer.
-            # @param [String] street The number and street address where you or your customer
-            #   is located.
-            # @param [String] city The city in which you or your customer is located.
-            # @param [String] region The state or region in which you or your customer is
-            #   located.
-            # @param [String] postal_code The postal code in which you or your customer is
-            #   located.
-            # @param [String] iso_country The ISO country code of your or your customer's
-            #   address.
-            # @param [String] friendly_name A human-readable description of the new address.
-            #   Maximum 64 characters.
-            # @param [Boolean] emergency_enabled The emergency_enabled
-            # @param [Boolean] auto_correct_address If you don't set a value for this
-            #   parameter, or if you set it to `true`, then the system will, if necessary,
-            #   auto-correct the address you provide. If you don't want the system to
-            #   auto-correct the address, you will explicitly need to set this value to `false`.
+            # @param [String] customer_name The name to associate with the new address.
+            # @param [String] street The number and street address of the new address.
+            # @param [String] city The city of the new address.
+            # @param [String] region The state or region of the new address.
+            # @param [String] postal_code The postal code of the new address.
+            # @param [String] iso_country The ISO country code of the new address.
+            # @param [String] friendly_name A descriptive string that you create to describe
+            #   the new address. It can be up to 64 characters long.
+            # @param [Boolean] emergency_enabled Whether to enable emergency calling on the
+            #   new address. Can be: `true` or `false`.
+            # @param [Boolean] auto_correct_address Whether we should automatically correct
+            #   the address. Can be: `true` or `false` and the default is `true`. If empty or
+            #   `true`, we will correct the address you provide if necessary. If `false`, we
+            #   won't alter the address you provide.
             # @return [AddressInstance] Newly created AddressInstance
             def create(customer_name: nil, street: nil, city: nil, region: nil, postal_code: nil, iso_country: nil, friendly_name: :unset, emergency_enabled: :unset, auto_correct_address: :unset)
               data = Twilio::Values.of({
@@ -75,11 +71,12 @@ module Twilio
             # Lists AddressInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [String] customer_name Only return the Address resources with customer
-            #   names that exactly match this name.
-            # @param [String] friendly_name Only return the Address resources with friendly
-            #   names that exactly match this name.
-            # @param [String] iso_country Only return the Address resources in this country.
+            # @param [String] customer_name The `customer_name` of the Address resources to
+            #   read.
+            # @param [String] friendly_name The string that identifies the Address resources
+            #   to read.
+            # @param [String] iso_country The ISO country code of the Address resources to
+            #   read.
             # @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
@@ -101,11 +98,12 @@ module Twilio
             # Streams AddressInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [String] customer_name Only return the Address resources with customer
-            #   names that exactly match this name.
-            # @param [String] friendly_name Only return the Address resources with friendly
-            #   names that exactly match this name.
-            # @param [String] iso_country Only return the Address resources in this country.
+            # @param [String] customer_name The `customer_name` of the Address resources to
+            #   read.
+            # @param [String] friendly_name The string that identifies the Address resources
+            #   to read.
+            # @param [String] iso_country The ISO country code of the Address resources to
+            #   read.
             # @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
@@ -143,11 +141,12 @@ module Twilio
             ##
             # Retrieve a single page of AddressInstance records from the API.
             # Request is executed immediately.
-            # @param [String] customer_name Only return the Address resources with customer
-            #   names that exactly match this name.
-            # @param [String] friendly_name Only return the Address resources with friendly
-            #   names that exactly match this name.
-            # @param [String] iso_country Only return the Address resources in this country.
+            # @param [String] customer_name The `customer_name` of the Address resources to
+            #   read.
+            # @param [String] friendly_name The string that identifies the Address resources
+            #   to read.
+            # @param [String] iso_country The ISO country code of the Address resources to
+            #   read.
             # @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
@@ -222,8 +221,11 @@ module Twilio
             ##
             # Initialize the AddressContext
             # @param [Version] version Version that contains the resource
-            # @param [String] account_sid The account_sid
-            # @param [String] sid The sid
+            # @param [String] account_sid The SID of the
+            #   [Account](https://www.twilio.com/docs/api/rest/account) that is responsible for
+            #   the Address resource to fetch.
+            # @param [String] sid The Twilio-provided string that uniquely identifies the
+            #   Address resource to fetch.
             # @return [AddressContext] AddressContext
             def initialize(version, account_sid, sid)
               super(version)
@@ -260,22 +262,19 @@ module Twilio
 
             ##
             # Update the AddressInstance
-            # @param [String] friendly_name A human-readable description of the address.
-            #   Maximum 64 characters.
-            # @param [String] customer_name Your name or business name, or that of your
-            #   customer.
-            # @param [String] street The number and street address where you or your customer
-            #   is located.
-            # @param [String] city The city in which you or your customer is located.
-            # @param [String] region The state or region in which you or your customer is
-            #   located.
-            # @param [String] postal_code The postal code in which you or your customer is
-            #   located.
-            # @param [Boolean] emergency_enabled The emergency_enabled
-            # @param [Boolean] auto_correct_address If you don't set a value for this
-            #   parameter, or if you set it to `true`, then the system will, if necessary,
-            #   auto-correct the address you provide. If you don't want the system to
-            #   auto-correct the address, you will explicitly need to set this value to `false`.
+            # @param [String] friendly_name A descriptive string that you create to describe
+            #   the address. It can be up to 64 characters long.
+            # @param [String] customer_name The name to associate with the address.
+            # @param [String] street The number and street address of the address.
+            # @param [String] city The city of the address.
+            # @param [String] region The state or region of the address.
+            # @param [String] postal_code The postal code of the address.
+            # @param [Boolean] emergency_enabled Whether to enable emergency calling on the
+            #   address. Can be: `true` or `false`.
+            # @param [Boolean] auto_correct_address Whether we should automatically correct
+            #   the address. Can be: `true` or `false` and the default is `true`. If empty or
+            #   `true`, we will correct the address you provide if necessary. If `false`, we
+            #   won't alter the address you provide.
             # @return [AddressInstance] Updated AddressInstance
             def update(friendly_name: :unset, customer_name: :unset, street: :unset, city: :unset, region: :unset, postal_code: :unset, emergency_enabled: :unset, auto_correct_address: :unset)
               data = Twilio::Values.of({
@@ -327,10 +326,11 @@ module Twilio
             # Initialize the AddressInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] account_sid The unique id of the
-            #   [Account](https://www.twilio.com/docs/iam/api/account) responsible for this
-            #   address.
-            # @param [String] sid The sid
+            # @param [String] account_sid The SID of the
+            #   [Account](https://www.twilio.com/docs/api/rest/account) that is responsible for
+            #   the Address resource.
+            # @param [String] sid The Twilio-provided string that uniquely identifies the
+            #   Address resource to fetch.
             # @return [AddressInstance] AddressInstance
             def initialize(version, payload, account_sid: nil, sid: nil)
               super(version)
@@ -370,85 +370,85 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique id of the Account responsible for this address.
+            # @return [String] The SID of the Account that is responsible for the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The city in which you or your customer is located.
+            # @return [String] The city in which the address is located
             def city
               @properties['city']
             end
 
             ##
-            # @return [String] Your name or business name, or that of your customer.
+            # @return [String] The name associated with the address
             def customer_name
               @properties['customer_name']
             end
 
             ##
-            # @return [Time] The date_created
+            # @return [Time] The RFC 2822 date and time in GMT that the resource was created
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date_updated
+            # @return [Time] The RFC 2822 date and time in GMT that the resource was last updated
             def date_updated
               @properties['date_updated']
             end
 
             ##
-            # @return [String] A human-readable description of the address.
+            # @return [String] The string that you assigned to describe the resource
             def friendly_name
               @properties['friendly_name']
             end
 
             ##
-            # @return [String] The ISO country code of your or your customer's address.
+            # @return [String] The ISO country code of the address
             def iso_country
               @properties['iso_country']
             end
 
             ##
-            # @return [String] The postal code in which you or your customer is located.
+            # @return [String] The postal code of the address
             def postal_code
               @properties['postal_code']
             end
 
             ##
-            # @return [String] The state or region in which you or your customer is located.
+            # @return [String] The state or region of the address
             def region
               @properties['region']
             end
 
             ##
-            # @return [String] A 34 character string that uniquely identifies this address.
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The number and street address where you or your customer is located.
+            # @return [String] The number and street address of the address
             def street
               @properties['street']
             end
 
             ##
-            # @return [String] The URI for this resource, relative to https://api.
+            # @return [String] The URI of the resource, relative to `https://api.twilio.com`
             def uri
               @properties['uri']
             end
 
             ##
-            # @return [Boolean] This is a value that indicates if emergency calling has been enabled on this number.
+            # @return [Boolean] Whether emergency calling has been enabled on this number
             def emergency_enabled
               @properties['emergency_enabled']
             end
 
             ##
-            # @return [Boolean] In some countries, addresses are validated to comply with local regulation.
+            # @return [Boolean] Whether the address has been validated to comply with local regulation
             def validated
               @properties['validated']
             end
@@ -469,22 +469,19 @@ module Twilio
 
             ##
             # Update the AddressInstance
-            # @param [String] friendly_name A human-readable description of the address.
-            #   Maximum 64 characters.
-            # @param [String] customer_name Your name or business name, or that of your
-            #   customer.
-            # @param [String] street The number and street address where you or your customer
-            #   is located.
-            # @param [String] city The city in which you or your customer is located.
-            # @param [String] region The state or region in which you or your customer is
-            #   located.
-            # @param [String] postal_code The postal code in which you or your customer is
-            #   located.
-            # @param [Boolean] emergency_enabled The emergency_enabled
-            # @param [Boolean] auto_correct_address If you don't set a value for this
-            #   parameter, or if you set it to `true`, then the system will, if necessary,
-            #   auto-correct the address you provide. If you don't want the system to
-            #   auto-correct the address, you will explicitly need to set this value to `false`.
+            # @param [String] friendly_name A descriptive string that you create to describe
+            #   the address. It can be up to 64 characters long.
+            # @param [String] customer_name The name to associate with the address.
+            # @param [String] street The number and street address of the address.
+            # @param [String] city The city of the address.
+            # @param [String] region The state or region of the address.
+            # @param [String] postal_code The postal code of the address.
+            # @param [Boolean] emergency_enabled Whether to enable emergency calling on the
+            #   address. Can be: `true` or `false`.
+            # @param [Boolean] auto_correct_address Whether we should automatically correct
+            #   the address. Can be: `true` or `false` and the default is `true`. If empty or
+            #   `true`, we will correct the address you provide if necessary. If `false`, we
+            #   won't alter the address you provide.
             # @return [AddressInstance] Updated AddressInstance
             def update(friendly_name: :unset, customer_name: :unset, street: :unset, city: :unset, region: :unset, postal_code: :unset, emergency_enabled: :unset, auto_correct_address: :unset)
               context.update(

data/lib/twilio-ruby/rest/api/v2010/account/address/dependent_phone_number.rb

@@ -17,8 +17,8 @@ module Twilio
               # Initialize the DependentPhoneNumberList
               # @param [Version] version Version that contains the resource
               # @param [String] account_sid The account_sid
-              # @param [String] address_sid A 34 character string that uniquely identifies this
-              #   address.
+              # @param [String] address_sid The unique string that that we created to identify
+              #   the Address resource.
               # @return [DependentPhoneNumberList] DependentPhoneNumberList
               def initialize(version, account_sid: nil, address_sid: nil)
                 super(version)
@@ -157,8 +157,8 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] account_sid The account_sid
-              # @param [String] address_sid A 34 character string that uniquely identifies this
-              #   address.
+              # @param [String] address_sid The unique string that that we created to identify
+              #   the Address resource.
               # @return [DependentPhoneNumberInstance] DependentPhoneNumberInstance
               def initialize(version, payload, account_sid: nil, address_sid: nil)
                 super(version)