twilio-ruby 5.40.3 → 5.74.1

data/lib/twilio-ruby/rest/video/v1/recording.rb

@@ -30,13 +30,13 @@ module Twilio
           # @param [recording.Status] status Read only the recordings that have this status.
           #   Can be: `processing`, `completed`, or `deleted`.
           # @param [String] source_sid Read only the recordings that have this `source_sid`.
-          # @param [String] grouping_sid Read only recordings with this `grouping_sid`,
-          #   which may include a `participant_sid` and/or a `room_sid`.
+          # @param [Array[String]] grouping_sid Read only recordings with this
+          #   `grouping_sid`, which may include a `participant_sid` and/or a `room_sid`.
           # @param [Time] date_created_after Read only recordings that started on or after
-          #   this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time
+          #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time
           #   zone.
           # @param [Time] date_created_before Read only recordings that started before this
-          #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time zone,
+          #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time zone,
           #   given as `YYYY-MM-DDThh:mm:ss+|-hh:mm` or `YYYY-MM-DDThh:mm:ssZ`.
           # @param [recording.Type] media_type Read only recordings that have this media
           #   type. Can be either `audio` or `video`.
@@ -67,13 +67,13 @@ module Twilio
           # @param [recording.Status] status Read only the recordings that have this status.
           #   Can be: `processing`, `completed`, or `deleted`.
           # @param [String] source_sid Read only the recordings that have this `source_sid`.
-          # @param [String] grouping_sid Read only recordings with this `grouping_sid`,
-          #   which may include a `participant_sid` and/or a `room_sid`.
+          # @param [Array[String]] grouping_sid Read only recordings with this
+          #   `grouping_sid`, which may include a `participant_sid` and/or a `room_sid`.
           # @param [Time] date_created_after Read only recordings that started on or after
-          #   this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time
+          #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time
           #   zone.
           # @param [Time] date_created_before Read only recordings that started before this
-          #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time zone,
+          #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time zone,
           #   given as `YYYY-MM-DDThh:mm:ss+|-hh:mm` or `YYYY-MM-DDThh:mm:ssZ`.
           # @param [recording.Type] media_type Read only recordings that have this media
           #   type. Can be either `audio` or `video`.
@@ -120,13 +120,13 @@ module Twilio
           # @param [recording.Status] status Read only the recordings that have this status.
           #   Can be: `processing`, `completed`, or `deleted`.
           # @param [String] source_sid Read only the recordings that have this `source_sid`.
-          # @param [String] grouping_sid Read only recordings with this `grouping_sid`,
-          #   which may include a `participant_sid` and/or a `room_sid`.
+          # @param [Array[String]] grouping_sid Read only recordings with this
+          #   `grouping_sid`, which may include a `participant_sid` and/or a `room_sid`.
           # @param [Time] date_created_after Read only recordings that started on or after
-          #   this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time
+          #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time
           #   zone.
           # @param [Time] date_created_before Read only recordings that started before this
-          #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time with time zone,
+          #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time zone,
           #   given as `YYYY-MM-DDThh:mm:ss+|-hh:mm` or `YYYY-MM-DDThh:mm:ssZ`.
           # @param [recording.Type] media_type Read only recordings that have this media
           #   type. Can be either `audio` or `video`.
@@ -263,7 +263,7 @@ module Twilio
                 'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                 'sid' => payload['sid'],
                 'source_sid' => payload['source_sid'],
-                'size' => payload['size'].to_i,
+                'size' => payload['size'] == nil ? payload['size'] : payload['size'].to_i,
                 'url' => payload['url'],
                 'type' => payload['type'],
                 'duration' => payload['duration'] == nil ? payload['duration'] : payload['duration'].to_i,
@@ -271,7 +271,10 @@ module Twilio
                 'codec' => payload['codec'],
                 'grouping_sids' => payload['grouping_sids'],
                 'track_name' => payload['track_name'],
-                'offset' => payload['offset'].to_i,
+                'offset' => payload['offset'] == nil ? payload['offset'] : payload['offset'].to_i,
+                'media_external_location' => payload['media_external_location'],
+                'status_callback' => payload['status_callback'],
+                'status_callback_method' => payload['status_callback_method'],
                 'links' => payload['links'],
             }
 
@@ -375,6 +378,24 @@ module Twilio
             @properties['offset']
           end
 
+          ##
+          # @return [String] The URL of the media file associated with the recording when stored externally
+          def media_external_location
+            @properties['media_external_location']
+          end
+
+          ##
+          # @return [String] The URL called to send status information on every recording event.
+          def status_callback
+            @properties['status_callback']
+          end
+
+          ##
+          # @return [String] The HTTP method used to call `status_callback`
+          def status_callback_method
+            @properties['status_callback_method']
+          end
+
           ##
           # @return [String] The URLs of related resources
           def links

data/lib/twilio-ruby/rest/video/v1/recording_settings.rb

@@ -89,9 +89,9 @@ module Twilio
           #   encryption.
           # @param [String] aws_s3_url The URL of the AWS S3 bucket where the recordings
           #   should be stored. We only support DNS-compliant URLs like
-          #   `https://<my-bucket>.s3-<aws-region>.amazonaws.com/recordings`, where
-          #   `recordings` is the path in which you want the recordings to be stored. This URL
-          #   accepts only URI-valid characters, as described in the <a
+          #   `https://documentation-example-twilio-bucket/recordings`, where `recordings` is
+          #   the path in which you want the recordings to be stored. This URL accepts only
+          #   URI-valid characters, as described in the <a
           #   href='https://tools.ietf.org/html/rfc3986#section-2'>RFC 3986</a>.
           # @param [Boolean] aws_storage_enabled Whether all recordings should be written to
           #   the `aws_s3_url`. When `false`, all recordings are stored in our cloud.
@@ -229,9 +229,9 @@ module Twilio
           #   encryption.
           # @param [String] aws_s3_url The URL of the AWS S3 bucket where the recordings
           #   should be stored. We only support DNS-compliant URLs like
-          #   `https://<my-bucket>.s3-<aws-region>.amazonaws.com/recordings`, where
-          #   `recordings` is the path in which you want the recordings to be stored. This URL
-          #   accepts only URI-valid characters, as described in the <a
+          #   `https://documentation-example-twilio-bucket/recordings`, where `recordings` is
+          #   the path in which you want the recordings to be stored. This URL accepts only
+          #   URI-valid characters, as described in the <a
           #   href='https://tools.ietf.org/html/rfc3986#section-2'>RFC 3986</a>.
           # @param [Boolean] aws_storage_enabled Whether all recordings should be written to
           #   the `aws_s3_url`. When `false`, all recordings are stored in our cloud.

data/lib/twilio-ruby/rest/video/v1/room/recording.rb

@@ -34,9 +34,9 @@ module Twilio
             #   Can be: `processing`, `completed`, or `deleted`.
             # @param [String] source_sid Read only the recordings that have this `source_sid`.
             # @param [Time] date_created_after Read only recordings that started on or after
-            #   this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone.
+            #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with time zone.
             # @param [Time] date_created_before Read only Recordings that started before this
-            #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone.
+            #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with time zone.
             # @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
@@ -63,9 +63,9 @@ module Twilio
             #   Can be: `processing`, `completed`, or `deleted`.
             # @param [String] source_sid Read only the recordings that have this `source_sid`.
             # @param [Time] date_created_after Read only recordings that started on or after
-            #   this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone.
+            #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with time zone.
             # @param [Time] date_created_before Read only Recordings that started before this
-            #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone.
+            #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with time zone.
             # @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
@@ -108,9 +108,9 @@ module Twilio
             #   Can be: `processing`, `completed`, or `deleted`.
             # @param [String] source_sid Read only the recordings that have this `source_sid`.
             # @param [Time] date_created_after Read only recordings that started on or after
-            #   this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone.
+            #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with time zone.
             # @param [Time] date_created_before Read only Recordings that started before this
-            #   [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) datetime with time zone.
+            #   {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] datetime with time zone.
             # @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
@@ -246,7 +246,7 @@ module Twilio
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'sid' => payload['sid'],
                   'source_sid' => payload['source_sid'],
-                  'size' => payload['size'].to_i,
+                  'size' => payload['size'] == nil ? payload['size'] : payload['size'].to_i,
                   'url' => payload['url'],
                   'type' => payload['type'],
                   'duration' => payload['duration'] == nil ? payload['duration'] : payload['duration'].to_i,
@@ -254,7 +254,8 @@ module Twilio
                   'codec' => payload['codec'],
                   'grouping_sids' => payload['grouping_sids'],
                   'track_name' => payload['track_name'],
-                  'offset' => payload['offset'].to_i,
+                  'offset' => payload['offset'] == nil ? payload['offset'] : payload['offset'].to_i,
+                  'media_external_location' => payload['media_external_location'],
                   'room_sid' => payload['room_sid'],
                   'links' => payload['links'],
               }
@@ -359,6 +360,12 @@ module Twilio
               @properties['offset']
             end
 
+            ##
+            # @return [String] The URL of the media file associated with the recording when stored externally
+            def media_external_location
+              @properties['media_external_location']
+            end
+
             ##
             # @return [String] The SID of the Room resource the recording is associated with
             def room_sid

data/lib/twilio-ruby/rest/video/v1/room/room_participant/room_participant_anonymize.rb

@@ -0,0 +1,240 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Video < Domain
+      class V1 < Version
+        class RoomContext < InstanceContext
+          class ParticipantContext < InstanceContext
+            class AnonymizeList < ListResource
+              ##
+              # Initialize the AnonymizeList
+              # @param [Version] version Version that contains the resource
+              # @param [String] room_sid The SID of the participant's room.
+              # @param [String] sid The unique string that we created to identify the
+              #   RoomParticipant resource.
+              # @return [AnonymizeList] AnonymizeList
+              def initialize(version, room_sid: nil, sid: nil)
+                super(version)
+
+                # Path Solution
+                @solution = {room_sid: room_sid, sid: sid}
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '#<Twilio.Video.V1.AnonymizeList>'
+              end
+            end
+
+            class AnonymizePage < Page
+              ##
+              # Initialize the AnonymizePage
+              # @param [Version] version Version that contains the resource
+              # @param [Response] response Response from the API
+              # @param [Hash] solution Path solution for the resource
+              # @return [AnonymizePage] AnonymizePage
+              def initialize(version, response, solution)
+                super(version, response)
+
+                # Path Solution
+                @solution = solution
+              end
+
+              ##
+              # Build an instance of AnonymizeInstance
+              # @param [Hash] payload Payload response from the API
+              # @return [AnonymizeInstance] AnonymizeInstance
+              def get_instance(payload)
+                AnonymizeInstance.new(@version, payload, room_sid: @solution[:room_sid], sid: @solution[:sid], )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                '<Twilio.Video.V1.AnonymizePage>'
+              end
+            end
+
+            class AnonymizeContext < InstanceContext
+              ##
+              # Initialize the AnonymizeContext
+              # @param [Version] version Version that contains the resource
+              # @param [String] room_sid The SID of the room with the participant to update.
+              # @param [String] sid The SID of the RoomParticipant resource to update.
+              # @return [AnonymizeContext] AnonymizeContext
+              def initialize(version, room_sid, sid)
+                super(version)
+
+                # Path Solution
+                @solution = {room_sid: room_sid, sid: sid, }
+                @uri = "/Rooms/#{@solution[:room_sid]}/Participants/#{@solution[:sid]}/Anonymize"
+              end
+
+              ##
+              # Update the AnonymizeInstance
+              # @return [AnonymizeInstance] Updated AnonymizeInstance
+              def update
+                payload = @version.update('POST', @uri)
+
+                AnonymizeInstance.new(@version, payload, room_sid: @solution[:room_sid], sid: @solution[:sid], )
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Video.V1.AnonymizeContext #{context}>"
+              end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+                "#<Twilio.Video.V1.AnonymizeContext #{context}>"
+              end
+            end
+
+            class AnonymizeInstance < InstanceResource
+              ##
+              # Initialize the AnonymizeInstance
+              # @param [Version] version Version that contains the resource
+              # @param [Hash] payload payload that contains response from Twilio
+              # @param [String] room_sid The SID of the participant's room.
+              # @param [String] sid The unique string that we created to identify the
+              #   RoomParticipant resource.
+              # @return [AnonymizeInstance] AnonymizeInstance
+              def initialize(version, payload, room_sid: nil, sid: nil)
+                super(version)
+
+                # Marshaled Properties
+                @properties = {
+                    'sid' => payload['sid'],
+                    'room_sid' => payload['room_sid'],
+                    'account_sid' => payload['account_sid'],
+                    'status' => payload['status'],
+                    'identity' => payload['identity'],
+                    'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                    'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                    'start_time' => Twilio.deserialize_iso8601_datetime(payload['start_time']),
+                    'end_time' => Twilio.deserialize_iso8601_datetime(payload['end_time']),
+                    'duration' => payload['duration'] == nil ? payload['duration'] : payload['duration'].to_i,
+                    'url' => payload['url'],
+                }
+
+                # Context
+                @instance_context = nil
+                @params = {'room_sid' => room_sid, '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 [AnonymizeContext] AnonymizeContext for this AnonymizeInstance
+              def context
+                unless @instance_context
+                  @instance_context = AnonymizeContext.new(@version, @params['room_sid'], @params['sid'], )
+                end
+                @instance_context
+              end
+
+              ##
+              # @return [String] The unique string that identifies the resource
+              def sid
+                @properties['sid']
+              end
+
+              ##
+              # @return [String] The SID of the participant's room
+              def room_sid
+                @properties['room_sid']
+              end
+
+              ##
+              # @return [String] The SID of the Account that created the resource
+              def account_sid
+                @properties['account_sid']
+              end
+
+              ##
+              # @return [anonymize.Status] The status of the Participant
+              def status
+                @properties['status']
+              end
+
+              ##
+              # @return [String] The SID of the participant
+              def identity
+                @properties['identity']
+              end
+
+              ##
+              # @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 ISO 8601 date and time in GMT when the resource was last updated
+              def date_updated
+                @properties['date_updated']
+              end
+
+              ##
+              # @return [Time] The time of participant connected to the room in ISO 8601 format
+              def start_time
+                @properties['start_time']
+              end
+
+              ##
+              # @return [Time] The time when the participant disconnected from the room in ISO 8601 format
+              def end_time
+                @properties['end_time']
+              end
+
+              ##
+              # @return [String] Duration of time in seconds the participant was connected
+              def duration
+                @properties['duration']
+              end
+
+              ##
+              # @return [String] The absolute URL of the resource
+              def url
+                @properties['url']
+              end
+
+              ##
+              # Update the AnonymizeInstance
+              # @return [AnonymizeInstance] Updated AnonymizeInstance
+              def update
+                context.update
+              end
+
+              ##
+              # Provide a user friendly representation
+              def to_s
+                values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Video.V1.AnonymizeInstance #{values}>"
+              end
+
+              ##
+              # Provide a detailed, user friendly representation
+              def inspect
+                values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+                "<Twilio.Video.V1.AnonymizeInstance #{values}>"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twilio-ruby/rest/video/v1/room/room_participant/room_participant_subscribe_rule.rb

@@ -44,9 +44,9 @@ module Twilio
 
               ##
               # Update the SubscribeRulesInstance
-              # @param [Hash] rules A JSON-encoded array of subscribe rules. See the [Specifying
+              # @param [Hash] rules A JSON-encoded array of subscribe rules. See the {Specifying
               #   Subscribe
-              #   Rules](https://www.twilio.com/docs/video/api/track-subscriptions#specifying-sr)
+              #   Rules}[https://www.twilio.com/docs/video/api/track-subscriptions#specifying-sr]
               #   section for further information.
               # @return [SubscribeRulesInstance] Updated SubscribeRulesInstance
               def update(rules: :unset)
@@ -138,7 +138,7 @@ module Twilio
               end
 
               ##
-              # @return [String] A collection of Subscribe Rules that describe how to include or exclude matching tracks
+              # @return [Array[String]] A collection of Subscribe Rules that describe how to include or exclude matching tracks
               def rules
                 @properties['rules']
               end

data/lib/twilio-ruby/rest/video/v1/room/room_participant.rb

@@ -34,11 +34,11 @@ module Twilio
             #   Status is `connected`, for `completed` Rooms only `disconnected` Participants
             #   are returned.
             # @param [String] identity Read only the Participants with this
-            #   [User](https://www.twilio.com/docs/chat/rest/user-resource) `identity` value.
+            #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] `identity` value.
             # @param [Time] date_created_after Read only Participants that started after this
-            #   date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format.
+            #   date in {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601#UTC] format.
             # @param [Time] date_created_before Read only Participants that started before
-            #   this date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format.
+            #   this date in {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601#UTC] 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
@@ -66,11 +66,11 @@ module Twilio
             #   Status is `connected`, for `completed` Rooms only `disconnected` Participants
             #   are returned.
             # @param [String] identity Read only the Participants with this
-            #   [User](https://www.twilio.com/docs/chat/rest/user-resource) `identity` value.
+            #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] `identity` value.
             # @param [Time] date_created_after Read only Participants that started after this
-            #   date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format.
+            #   date in {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601#UTC] format.
             # @param [Time] date_created_before Read only Participants that started before
-            #   this date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format.
+            #   this date in {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601#UTC] 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
@@ -114,11 +114,11 @@ module Twilio
             #   Status is `connected`, for `completed` Rooms only `disconnected` Participants
             #   are returned.
             # @param [String] identity Read only the Participants with this
-            #   [User](https://www.twilio.com/docs/chat/rest/user-resource) `identity` value.
+            #   {User}[https://www.twilio.com/docs/chat/rest/user-resource] `identity` value.
             # @param [Time] date_created_after Read only Participants that started after this
-            #   date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format.
+            #   date in {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601#UTC] format.
             # @param [Time] date_created_before Read only Participants that started before
-            #   this date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format.
+            #   this date in {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601#UTC] 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
@@ -207,6 +207,7 @@ module Twilio
               @published_tracks = nil
               @subscribed_tracks = nil
               @subscribe_rules = nil
+              @anonymize = nil
             end
 
             ##
@@ -293,6 +294,14 @@ module Twilio
               @subscribe_rules
             end
 
+            ##
+            # Access the anonymize
+            # @return [AnonymizeList]
+            # @return [AnonymizeContext]
+            def anonymize
+              AnonymizeContext.new(@version, @solution[:room_sid], @solution[:sid], )
+            end
+
             ##
             # Provide a user friendly representation
             def to_s
@@ -462,6 +471,13 @@ module Twilio
               context.subscribe_rules
             end
 
+            ##
+            # Access the anonymize
+            # @return [anonymize] anonymize
+            def anonymize
+              context.anonymize
+            end
+
             ##
             # Provide a user friendly representation
             def to_s