plex_ruby_sdk 0.3.4

data/lib/plex_ruby_sdk/library.rb

@@ -0,0 +1,692 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday/multipart'
+require 'sorbet-runtime'
+
+module PlexRubySDK
+  extend T::Sig
+  class Library
+    extend T::Sig
+    # API Calls interacting with Plex Media Server Libraries
+    # 
+
+    sig { params(sdk_config: SDKConfiguration).void }
+    def initialize(sdk_config)
+      @sdk_configuration = sdk_config
+    end
+
+
+    sig { params(url: ::String, type: T.nilable(::Float)).returns(::PlexRubySDK::Operations::GetFileHashResponse) }
+    def get_file_hash(url, type = nil)
+      # get_file_hash - Get Hash Value
+      # This resource returns hash values for local files
+      request = ::PlexRubySDK::Operations::GetFileHashRequest.new(
+        
+        url: url,
+        type: type
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = "#{base_url}/library/hashes"
+      headers = {}
+      query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetFileHashRequest, request, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        req.params = query_params
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetFileHashResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetFileHashBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetFileHashUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(x_plex_container_start: T.nilable(::Integer), x_plex_container_size: T.nilable(::Integer)).returns(::PlexRubySDK::Operations::GetRecentlyAddedResponse) }
+    def get_recently_added(x_plex_container_start = nil, x_plex_container_size = nil)
+      # get_recently_added - Get Recently Added
+      # This endpoint will return the recently added content.
+      # 
+      request = ::PlexRubySDK::Operations::GetRecentlyAddedRequest.new(
+        
+        x_plex_container_start: x_plex_container_start,
+        x_plex_container_size: x_plex_container_size
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = "#{base_url}/library/recentlyAdded"
+      headers = {}
+      query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetRecentlyAddedRequest, request, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        req.params = query_params
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetRecentlyAddedResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetRecentlyAddedResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetRecentlyAddedBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetRecentlyAddedUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { returns(::PlexRubySDK::Operations::GetAllLibrariesResponse) }
+    def get_all_libraries
+      # get_all_libraries - Get All Libraries
+      # A library section (commonly referred to as just a library) is a collection of media. 
+      # Libraries are typed, and depending on their type provide either a flat or a hierarchical view of the media. 
+      # For example, a music library has an artist > albums > tracks structure, whereas a movie library is flat.
+      # 
+      # Libraries have features beyond just being a collection of media; for starters, they include information about supported types, filters and sorts. 
+      # This allows a client to provide a rich interface around the media (e.g. allow sorting movies by release year).
+      # 
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = "#{base_url}/library/sections"
+      headers = {}
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetAllLibrariesResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetAllLibrariesResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetAllLibrariesBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetAllLibrariesUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(section_key: ::Integer, include_details: T.nilable(::PlexRubySDK::Operations::IncludeDetails)).returns(::PlexRubySDK::Operations::GetLibraryDetailsResponse) }
+    def get_library_details(section_key, include_details = nil)
+      # get_library_details - Get Library Details
+      # ## Library Details Endpoint
+      # 
+      # This endpoint provides comprehensive details about the library, focusing on organizational aspects rather than the content itself.   
+      # 
+      # The details include:
+      # 
+      # ### Directories
+      # Organized into three categories:
+      # 
+      # - **Primary Directories**: 
+      #   - Used in some clients for quick access to media subsets (e.g., "All", "On Deck").
+      #   - Most can be replicated via media queries.
+      #   - Customizable by users.
+      # 
+      # - **Secondary Directories**:
+      #   - Marked with `secondary="1"`.
+      #   - Used in older clients for structured navigation.
+      # 
+      # - **Special Directories**:
+      #   - Includes a "By Folder" entry for filesystem-based browsing.
+      #   - Contains an obsolete `search="1"` entry for on-the-fly search dialog creation.
+      # 
+      # ### Types
+      # Each type in the library comes with a set of filters and sorts, aiding in building dynamic media controls:
+      # 
+      # - **Type Object Attributes**:
+      #   - `key`: Endpoint for the media list of this type.
+      #   - `type`: Metadata type (if standard Plex type).
+      #   - `title`: Title for this content type (e.g., "Movies").
+      # 
+      # - **Filter Objects**:
+      #   - Subset of the media query language.
+      #   - Attributes include `filter` (name), `filterType` (data type), `key` (endpoint for value range), and `title`.
+      # 
+      # - **Sort Objects**:
+      #   - Description of sort fields.
+      #   - Attributes include `defaultDirection` (asc/desc), `descKey` and `key` (sort parameters), and `title`.
+      # 
+      # > **Note**: Filters and sorts are optional; without them, no filtering controls are rendered.
+      # 
+      request = ::PlexRubySDK::Operations::GetLibraryDetailsRequest.new(
+        
+        section_key: section_key,
+        include_details: include_details
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        ::PlexRubySDK::Operations::GetLibraryDetailsRequest,
+        base_url,
+        '/library/sections/{sectionKey}',
+        request,
+        @sdk_configuration.globals
+      )
+      headers = {}
+      query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetLibraryDetailsRequest, request, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        req.params = query_params
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetLibraryDetailsResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetLibraryDetailsResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetLibraryDetailsBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetLibraryDetailsUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(section_key: ::Integer).returns(::PlexRubySDK::Operations::DeleteLibraryResponse) }
+    def delete_library(section_key)
+      # delete_library - Delete Library Section
+      # Delete a library using a specific section id
+      request = ::PlexRubySDK::Operations::DeleteLibraryRequest.new(
+        
+        section_key: section_key
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        ::PlexRubySDK::Operations::DeleteLibraryRequest,
+        base_url,
+        '/library/sections/{sectionKey}',
+        request,
+        @sdk_configuration.globals
+      )
+      headers = {}
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.delete(url) do |req|
+        req.headers = headers
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::DeleteLibraryResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::DeleteLibraryBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::DeleteLibraryUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(request: T.nilable(::PlexRubySDK::Operations::GetLibraryItemsRequest)).returns(::PlexRubySDK::Operations::GetLibraryItemsResponse) }
+    def get_library_items(request)
+      # get_library_items - Get Library Items
+      # Fetches details from a specific section of the library identified by a section key and a tag. The tag parameter accepts the following values:
+      # - `all`: All items in the section.
+      # - `unwatched`: Items that have not been played.
+      # - `newest`: Items that are recently released.
+      # - `recentlyAdded`: Items that are recently added to the library.
+      # - `recentlyViewed`: Items that were recently viewed.
+      # - `onDeck`: Items to continue watching.
+      # - `collection`: Items categorized by collection.
+      # - `edition`: Items categorized by edition.
+      # - `genre`: Items categorized by genre.
+      # - `year`: Items categorized by year of release.
+      # - `decade`: Items categorized by decade.
+      # - `director`: Items categorized by director.
+      # - `actor`: Items categorized by starring actor.
+      # - `country`: Items categorized by country of origin.
+      # - `contentRating`: Items categorized by content rating.
+      # - `rating`: Items categorized by rating.
+      # - `resolution`: Items categorized by resolution.
+      # - `firstCharacter`: Items categorized by the first letter.
+      # - `folder`: Items categorized by folder.
+      # 
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        ::PlexRubySDK::Operations::GetLibraryItemsRequest,
+        base_url,
+        '/library/sections/{sectionKey}/{tag}',
+        request,
+        @sdk_configuration.globals
+      )
+      headers = {}
+      query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetLibraryItemsRequest, request, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        req.params = query_params
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetLibraryItemsResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetLibraryItemsResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetLibraryItemsBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetLibraryItemsUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(section_key: ::Integer, force: T.nilable(::PlexRubySDK::Operations::Force)).returns(::PlexRubySDK::Operations::GetRefreshLibraryMetadataResponse) }
+    def get_refresh_library_metadata(section_key, force = nil)
+      # get_refresh_library_metadata - Refresh Metadata Of The Library
+      # This endpoint Refreshes all the Metadata of the library.
+      # 
+      request = ::PlexRubySDK::Operations::GetRefreshLibraryMetadataRequest.new(
+        
+        section_key: section_key,
+        force: force
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        ::PlexRubySDK::Operations::GetRefreshLibraryMetadataRequest,
+        base_url,
+        '/library/sections/{sectionKey}/refresh',
+        request,
+        @sdk_configuration.globals
+      )
+      headers = {}
+      query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetRefreshLibraryMetadataRequest, request, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        req.params = query_params
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetRefreshLibraryMetadataResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetRefreshLibraryMetadataBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetRefreshLibraryMetadataUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(section_key: ::Integer, type: ::PlexRubySDK::Operations::QueryParamType).returns(::PlexRubySDK::Operations::GetSearchLibraryResponse) }
+    def get_search_library(section_key, type)
+      # get_search_library - Search Library
+      # Search for content within a specific section of the library.
+      # 
+      # ### Types
+      # Each type in the library comes with a set of filters and sorts, aiding in building dynamic media controls:
+      # 
+      # - **Type Object Attributes**:
+      #   - `type`: Metadata type (if standard Plex type).  
+      #   - `title`: Title for this content type (e.g., "Movies").
+      # 
+      # - **Filter Objects**:
+      #   - Subset of the media query language.
+      #   - Attributes include `filter` (name), `filterType` (data type), `key` (endpoint for value range), and `title`.
+      # 
+      # - **Sort Objects**:
+      #   - Description of sort fields.
+      #   - Attributes include `defaultDirection` (asc/desc), `descKey` and `key` (sort parameters), and `title`.
+      # 
+      # > **Note**: Filters and sorts are optional; without them, no filtering controls are rendered.
+      # 
+      request = ::PlexRubySDK::Operations::GetSearchLibraryRequest.new(
+        
+        section_key: section_key,
+        type: type
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        ::PlexRubySDK::Operations::GetSearchLibraryRequest,
+        base_url,
+        '/library/sections/{sectionKey}/search',
+        request,
+        @sdk_configuration.globals
+      )
+      headers = {}
+      query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetSearchLibraryRequest, request, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        req.params = query_params
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetSearchLibraryResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetSearchLibraryResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetSearchLibraryBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetSearchLibraryUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(rating_key: ::Integer).returns(::PlexRubySDK::Operations::GetMetaDataByRatingKeyResponse) }
+    def get_meta_data_by_rating_key(rating_key)
+      # get_meta_data_by_rating_key - Get Metadata by RatingKey
+      # This endpoint will return the metadata of a library item specified with the ratingKey.
+      # 
+      request = ::PlexRubySDK::Operations::GetMetaDataByRatingKeyRequest.new(
+        
+        rating_key: rating_key
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        ::PlexRubySDK::Operations::GetMetaDataByRatingKeyRequest,
+        base_url,
+        '/library/metadata/{ratingKey}',
+        request,
+        @sdk_configuration.globals
+      )
+      headers = {}
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetMetaDataByRatingKeyResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetMetaDataByRatingKeyResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetMetaDataByRatingKeyBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetMetaDataByRatingKeyUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(rating_key: ::Float, include_elements: T.nilable(::String)).returns(::PlexRubySDK::Operations::GetMetadataChildrenResponse) }
+    def get_metadata_children(rating_key, include_elements = nil)
+      # get_metadata_children - Get Items Children
+      # This endpoint will return the children of of a library item specified with the ratingKey.
+      # 
+      request = ::PlexRubySDK::Operations::GetMetadataChildrenRequest.new(
+        
+        rating_key: rating_key,
+        include_elements: include_elements
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = Utils.generate_url(
+        ::PlexRubySDK::Operations::GetMetadataChildrenRequest,
+        base_url,
+        '/library/metadata/{ratingKey}/children',
+        request,
+        @sdk_configuration.globals
+      )
+      headers = {}
+      query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetMetadataChildrenRequest, request, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        req.params = query_params
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetMetadataChildrenResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetMetadataChildrenResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetMetadataChildrenBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetMetadataChildrenUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { params(type: ::PlexRubySDK::Operations::GetTopWatchedContentQueryParamType, include_guids: T.nilable(::Integer)).returns(::PlexRubySDK::Operations::GetTopWatchedContentResponse) }
+    def get_top_watched_content(type, include_guids = nil)
+      # get_top_watched_content - Get Top Watched Content
+      # This endpoint will return the top watched content from libraries of a certain type
+      # 
+      request = ::PlexRubySDK::Operations::GetTopWatchedContentRequest.new(
+        
+        type: type,
+        include_guids: include_guids
+      )
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = "#{base_url}/library/all/top"
+      headers = {}
+      query_params = Utils.get_query_params(::PlexRubySDK::Operations::GetTopWatchedContentRequest, request, @sdk_configuration.globals)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        req.params = query_params
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetTopWatchedContentResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetTopWatchedContentResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetTopWatchedContentBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetTopWatchedContentUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+
+
+    sig { returns(::PlexRubySDK::Operations::GetOnDeckResponse) }
+    def get_on_deck
+      # get_on_deck - Get On Deck
+      # This endpoint will return the on deck content.
+      # 
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = "#{base_url}/library/onDeck"
+      headers = {}
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      r = @sdk_configuration.client.get(url) do |req|
+        req.headers = headers
+        Utils.configure_request_security(req, @sdk_configuration.security) if !@sdk_configuration.nil? && !@sdk_configuration.security.nil?
+      end
+
+      content_type = r.headers.fetch('Content-Type', 'application/octet-stream')
+
+      res = ::PlexRubySDK::Operations::GetOnDeckResponse.new(
+        status_code: r.status, content_type: content_type, raw_response: r
+      )
+      if r.status == 200
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetOnDeckResponseBody)
+          res.object = out
+        end
+      elsif r.status == 400
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetOnDeckBadRequest)
+          res.bad_request = out
+        end
+      elsif r.status == 401
+        if Utils.match_content_type(content_type, 'application/json')
+          out = Utils.unmarshal_complex(r.env.response_body, ::PlexRubySDK::Operations::GetOnDeckUnauthorized)
+          res.unauthorized = out
+        end
+      end
+      res
+    end
+  end
+end