twilio-ruby 5.40.3 → 5.74.1

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

@@ -13,11 +13,11 @@ module Twilio
     class Client
       @@default_region = 'us1'
 
-      attr_accessor :http_client, :username, :password, :account_sid, :auth_token, :region, :edge
+      attr_accessor :http_client, :username, :password, :account_sid, :auth_token, :region, :edge, :logger, :user_agent_extensions
 
       ##
       # Initializes the Twilio Client
-      def initialize(username=nil, password=nil, account_sid=nil, region=nil, http_client=nil)
+      def initialize(username=nil, password=nil, account_sid=nil, region=nil, http_client=nil, logger=nil, user_agent_extensions=nil)
         @username = username || Twilio.account_sid
         @password = password || Twilio.auth_token
         @region = region || Twilio.region
@@ -26,37 +26,45 @@ module Twilio
         @auth_token = @password
         @auth = [@username, @password]
         @http_client = http_client || Twilio.http_client || Twilio::HTTP::Client.new
+        @logger = logger || Twilio.logger
+        @user_agent_extensions = user_agent_extensions || []
 
         # Domains
         @accounts = nil
         @api = nil
         @autopilot = nil
         @chat = nil
+        @content = nil
         @conversations = nil
         @events = nil
-        @fax = nil
         @flex_api = nil
+        @frontline_api = nil
         @insights = nil
         @ip_messaging = nil
         @lookups = nil
+        @media = nil
         @messaging = nil
         @monitor = nil
         @notify = nil
         @numbers = nil
+        @oauth = nil
         @preview = nil
         @pricing = nil
         @proxy = nil
+        @routes = nil
         @serverless = nil
         @studio = nil
         @sync = nil
         @taskrouter = nil
         @trunking = nil
+        @trusthub = nil
         @verify = nil
         @video = nil
         @voice = nil
         @wireless = nil
         @supersim = nil
         @bulkexports = nil
+        @microvisor = nil
       end
 
       ##
@@ -65,11 +73,12 @@ module Twilio
       def request(host, port, method, uri, params={}, data={}, headers={}, auth=nil, timeout=nil)
         auth ||= @auth
 
-        headers['User-Agent'] = "twilio-ruby/#{Twilio::VERSION}" +
-                                " (#{RUBY_ENGINE}/#{RUBY_PLATFORM}" +
-                                " #{RUBY_VERSION}-p#{RUBY_PATCHLEVEL})"
+        ruby_config = RbConfig::CONFIG
+        headers['User-Agent'] = "twilio-ruby/#{Twilio::VERSION} (#{ruby_config["host_os"]} #{ruby_config["host_cpu"]}) Ruby/#{RUBY_VERSION}"
         headers['Accept-Charset'] = 'utf-8'
 
+        user_agent_extensions.each { |extension| headers['User-Agent'] += " #{extension}" }
+
         if method == 'POST' && !headers['Content-Type']
           headers['Content-Type'] = 'application/x-www-form-urlencoded'
         end
@@ -80,7 +89,24 @@ module Twilio
 
         uri = build_uri(uri)
 
-        @http_client.request(
+        if @logger
+          @logger.debug("--BEGIN Twilio API Request--")
+          @logger.debug("Request Method: <#{method}>")
+
+          headers.each do |key, value|
+            unless key.downcase == 'authorization'
+              @logger.debug("#{key}:#{value}")
+            end
+          end
+
+          url = URI(uri)
+          @logger.debug("Host:#{url.host}")
+          @logger.debug("Path:#{url.path}")
+          @logger.debug("Query:#{url.query}")
+          @logger.debug("Request Params:#{params}")
+        end
+
+        response = @http_client.request(
           host,
           port,
           method,
@@ -91,6 +117,14 @@ module Twilio
           auth,
           timeout
         )
+
+        if @logger
+          @logger.debug("Response Status Code:#{response.status_code}")
+          @logger.debug("Response Headers:#{response.headers}")
+          @logger.debug("--END TWILIO API REQUEST--")
+        end
+
+        response
       end
 
       ##
@@ -155,6 +189,12 @@ module Twilio
         @chat ||= Chat.new self
       end
 
+      ##
+      # Access the Content Twilio Domain
+      def content
+        @content ||= Content.new self
+      end
+
       ##
       # Access the Conversations Twilio Domain
       def conversations
@@ -167,18 +207,18 @@ module Twilio
         @events ||= Events.new self
       end
 
-      ##
-      # Access the Fax Twilio Domain
-      def fax
-        @fax ||= Fax.new self
-      end
-
       ##
       # Access the FlexApi Twilio Domain
       def flex_api
         @flex_api ||= FlexApi.new self
       end
 
+      ##
+      # Access the FrontlineApi Twilio Domain
+      def frontline_api
+        @frontline_api ||= FrontlineApi.new self
+      end
+
       ##
       # Access the Insights Twilio Domain
       def insights
@@ -197,6 +237,12 @@ module Twilio
         @lookups ||= Lookups.new self
       end
 
+      ##
+      # Access the Media Twilio Domain
+      def media
+        @media ||= Media.new self
+      end
+
       ##
       # Access the Messaging Twilio Domain
       def messaging
@@ -221,6 +267,12 @@ module Twilio
         @numbers ||= Numbers.new self
       end
 
+      ##
+      # Access the Oauth Twilio Domain
+      def oauth
+        @oauth ||= Oauth.new self
+      end
+
       ##
       # Access the Preview Twilio Domain
       def preview
@@ -239,6 +291,12 @@ module Twilio
         @proxy ||= Proxy.new self
       end
 
+      ##
+      # Access the Routes Twilio Domain
+      def routes
+        @routes ||= Routes.new self
+      end
+
       ##
       # Access the Serverless Twilio Domain
       def serverless
@@ -269,6 +327,12 @@ module Twilio
         @trunking ||= Trunking.new self
       end
 
+      ##
+      # Access the Trusthub Twilio Domain
+      def trusthub
+        @trusthub ||= Trusthub.new self
+      end
+
       ##
       # Access the Verify Twilio Domain
       def verify
@@ -305,6 +369,12 @@ module Twilio
         @bulkexports ||= Bulkexports.new self
       end
 
+      ##
+      # Access the Microvisor Twilio Domain
+      def microvisor
+        @microvisor ||= Microvisor.new self
+      end
+
       ##
       # @param [String] sid The unique string that that we created to identify the
       #   Address resource.
@@ -333,7 +403,7 @@ module Twilio
 
       ##
       # @param [String] country_code The
-      #   [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of
+      #   {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]
@@ -348,7 +418,7 @@ module Twilio
       end
 
       ##
-      # @param [String] sid The unique string that that we created to identify this Call
+      # @param [String] sid The unique string that we created to identify this Call
       #   resource.
       # @return [Twilio::REST::Api::V2010::AccountContext::CallInstance] if sid was passed.
       # @return [Twilio::REST::Api::V2010::AccountContext::CallList]

data/lib/twilio-ruby/rest/{preview/trusted_comms/business/brand.rb → content/v1/content/approval_fetch.rb}

@@ -8,40 +8,41 @@
 
 module Twilio
   module REST
-    class Preview < Domain
-      class TrustedComms < Version
-        class BusinessContext < InstanceContext
+    class Content < Domain
+      class V1 < Version
+        class ContentContext < InstanceContext
           ##
           # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
-          class BrandList < ListResource
+          class ApprovalFetchList < ListResource
             ##
-            # Initialize the BrandList
+            # Initialize the ApprovalFetchList
             # @param [Version] version Version that contains the resource
-            # @param [String] business_sid The unique SID identifier of the Business.
-            # @return [BrandList] BrandList
-            def initialize(version, business_sid: nil)
+            # @param [String] sid The unique string that that we created to identify the
+            #   Content resource.
+            # @return [ApprovalFetchList] ApprovalFetchList
+            def initialize(version, sid: nil)
               super(version)
 
               # Path Solution
-              @solution = {business_sid: business_sid}
+              @solution = {sid: sid}
             end
 
             ##
             # Provide a user friendly representation
             def to_s
-              '#<Twilio.Preview.TrustedComms.BrandList>'
+              '#<Twilio.Content.V1.ApprovalFetchList>'
             end
           end
 
           ##
           # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
-          class BrandPage < Page
+          class ApprovalFetchPage < Page
             ##
-            # Initialize the BrandPage
+            # Initialize the ApprovalFetchPage
             # @param [Version] version Version that contains the resource
             # @param [Response] response Response from the API
             # @param [Hash] solution Path solution for the resource
-            # @return [BrandPage] BrandPage
+            # @return [ApprovalFetchPage] ApprovalFetchPage
             def initialize(version, response, solution)
               super(version, response)
 
@@ -50,180 +51,141 @@ module Twilio
             end
 
             ##
-            # Build an instance of BrandInstance
+            # Build an instance of ApprovalFetchInstance
             # @param [Hash] payload Payload response from the API
-            # @return [BrandInstance] BrandInstance
+            # @return [ApprovalFetchInstance] ApprovalFetchInstance
             def get_instance(payload)
-              BrandInstance.new(@version, payload, business_sid: @solution[:business_sid], )
+              ApprovalFetchInstance.new(@version, payload, sid: @solution[:sid], )
             end
 
             ##
             # Provide a user friendly representation
             def to_s
-              '<Twilio.Preview.TrustedComms.BrandPage>'
+              '<Twilio.Content.V1.ApprovalFetchPage>'
             end
           end
 
           ##
           # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
-          class BrandContext < InstanceContext
+          class ApprovalFetchContext < InstanceContext
             ##
-            # Initialize the BrandContext
+            # Initialize the ApprovalFetchContext
             # @param [Version] version Version that contains the resource
-            # @param [String] business_sid The unique SID identifier of the Business.
-            # @param [String] sid The unique SID identifier of the Brand.
-            # @return [BrandContext] BrandContext
-            def initialize(version, business_sid, sid)
+            # @param [String] sid The Twilio-provided string that uniquely identifies the
+            #   Content resource whose approval information to fetch.
+            # @return [ApprovalFetchContext] ApprovalFetchContext
+            def initialize(version, sid)
               super(version)
 
               # Path Solution
-              @solution = {business_sid: business_sid, sid: sid, }
-              @uri = "/Businesses/#{@solution[:business_sid]}/Brands/#{@solution[:sid]}"
-
-              # Dependents
-              @branded_channels = nil
+              @solution = {sid: sid, }
+              @uri = "/Content/#{@solution[:sid]}/ApprovalRequests"
             end
 
             ##
-            # Fetch the BrandInstance
-            # @return [BrandInstance] Fetched BrandInstance
+            # Fetch the ApprovalFetchInstance
+            # @return [ApprovalFetchInstance] Fetched ApprovalFetchInstance
             def fetch
               payload = @version.fetch('GET', @uri)
 
-              BrandInstance.new(@version, payload, business_sid: @solution[:business_sid], sid: @solution[:sid], )
-            end
-
-            ##
-            # Access the branded_channels
-            # @return [BrandedChannelList]
-            # @return [BrandedChannelContext] if sid was passed.
-            def branded_channels(sid=:unset)
-              raise ArgumentError, 'sid cannot be nil' if sid.nil?
-
-              if sid != :unset
-                return BrandedChannelContext.new(@version, @solution[:business_sid], @solution[:sid], sid, )
-              end
-
-              unless @branded_channels
-                @branded_channels = BrandedChannelList.new(
-                    @version,
-                    business_sid: @solution[:business_sid],
-                    brand_sid: @solution[:sid],
-                )
-              end
-
-              @branded_channels
+              ApprovalFetchInstance.new(@version, payload, sid: @solution[:sid], )
             end
 
             ##
             # Provide a user friendly representation
             def to_s
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
-              "#<Twilio.Preview.TrustedComms.BrandContext #{context}>"
+              "#<Twilio.Content.V1.ApprovalFetchContext #{context}>"
             end
 
             ##
             # Provide a detailed, user friendly representation
             def inspect
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
-              "#<Twilio.Preview.TrustedComms.BrandContext #{context}>"
+              "#<Twilio.Content.V1.ApprovalFetchContext #{context}>"
             end
           end
 
           ##
           # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
-          class BrandInstance < InstanceResource
+          class ApprovalFetchInstance < InstanceResource
             ##
-            # Initialize the BrandInstance
+            # Initialize the ApprovalFetchInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] business_sid The unique SID identifier of the Business.
-            # @param [String] sid The unique SID identifier of the Brand.
-            # @return [BrandInstance] BrandInstance
-            def initialize(version, payload, business_sid: nil, sid: nil)
+            # @param [String] sid The unique string that that we created to identify the
+            #   Content resource.
+            # @return [ApprovalFetchInstance] ApprovalFetchInstance
+            def initialize(version, payload, sid: nil)
               super(version)
 
               # Marshaled Properties
               @properties = {
-                  'account_sid' => payload['account_sid'],
-                  'business_sid' => payload['business_sid'],
                   'sid' => payload['sid'],
-                  'links' => payload['links'],
+                  'account_sid' => payload['account_sid'],
+                  'whatsapp' => payload['whatsapp'],
                   'url' => payload['url'],
               }
 
               # Context
               @instance_context = nil
-              @params = {'business_sid' => business_sid, 'sid' => sid || @properties['sid'], }
+              @params = {'sid' => sid, }
             end
 
             ##
             # Generate an instance context for the instance, the context is capable of
             # performing various actions.  All instance actions are proxied to the context
-            # @return [BrandContext] BrandContext for this BrandInstance
+            # @return [ApprovalFetchContext] ApprovalFetchContext for this ApprovalFetchInstance
             def context
               unless @instance_context
-                @instance_context = BrandContext.new(@version, @params['business_sid'], @params['sid'], )
+                @instance_context = ApprovalFetchContext.new(@version, @params['sid'], )
               end
               @instance_context
             end
 
             ##
-            # @return [String] Account Sid.
-            def account_sid
-              @properties['account_sid']
-            end
-
-            ##
-            # @return [String] Business Sid.
-            def business_sid
-              @properties['business_sid']
+            # @return [String] The unique string that identifies the Content resource
+            def sid
+              @properties['sid']
             end
 
             ##
-            # @return [String] Brand Sid.
-            def sid
-              @properties['sid']
+            # @return [String] The SID of the Account that created the Content resource
+            def account_sid
+              @properties['account_sid']
             end
 
             ##
-            # @return [String] Nested resource URLs.
-            def links
-              @properties['links']
+            # @return [Hash] Contains the whatsapp approval information for the Content resource
+            def whatsapp
+              @properties['whatsapp']
             end
 
             ##
-            # @return [String] The URL of this resource.
+            # @return [String] The URL of the resource, relative to `https://content.twilio.com`
             def url
               @properties['url']
             end
 
             ##
-            # Fetch the BrandInstance
-            # @return [BrandInstance] Fetched BrandInstance
+            # Fetch the ApprovalFetchInstance
+            # @return [ApprovalFetchInstance] Fetched ApprovalFetchInstance
             def fetch
               context.fetch
             end
 
-            ##
-            # Access the branded_channels
-            # @return [branded_channels] branded_channels
-            def branded_channels
-              context.branded_channels
-            end
-
             ##
             # Provide a user friendly representation
             def to_s
               values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
-              "<Twilio.Preview.TrustedComms.BrandInstance #{values}>"
+              "<Twilio.Content.V1.ApprovalFetchInstance #{values}>"
             end
 
             ##
             # Provide a detailed, user friendly representation
             def inspect
               values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
-              "<Twilio.Preview.TrustedComms.BrandInstance #{values}>"
+              "<Twilio.Content.V1.ApprovalFetchInstance #{values}>"
             end
           end
         end