late-sdk 0.0.938 → 0.0.939

data/lib/zernio-sdk/models/create_youtube_playlist201_response_playlist.rb

@@ -0,0 +1,318 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class CreateYoutubePlaylist201ResponsePlaylist < ApiModelBase
+    attr_accessor :id
+
+    attr_accessor :title
+
+    attr_accessor :description
+
+    attr_accessor :privacy
+
+    attr_accessor :item_count
+
+    attr_accessor :thumbnail_url
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'id' => :'id',
+        :'title' => :'title',
+        :'description' => :'description',
+        :'privacy' => :'privacy',
+        :'item_count' => :'itemCount',
+        :'thumbnail_url' => :'thumbnailUrl'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'id' => :'String',
+        :'title' => :'String',
+        :'description' => :'String',
+        :'privacy' => :'String',
+        :'item_count' => :'Integer',
+        :'thumbnail_url' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::CreateYoutubePlaylist201ResponsePlaylist` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::CreateYoutubePlaylist201ResponsePlaylist`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'id')
+        self.id = attributes[:'id']
+      else
+        self.id = nil
+      end
+
+      if attributes.key?(:'title')
+        self.title = attributes[:'title']
+      else
+        self.title = nil
+      end
+
+      if attributes.key?(:'description')
+        self.description = attributes[:'description']
+      else
+        self.description = nil
+      end
+
+      if attributes.key?(:'privacy')
+        self.privacy = attributes[:'privacy']
+      else
+        self.privacy = nil
+      end
+
+      if attributes.key?(:'item_count')
+        self.item_count = attributes[:'item_count']
+      else
+        self.item_count = nil
+      end
+
+      if attributes.key?(:'thumbnail_url')
+        self.thumbnail_url = attributes[:'thumbnail_url']
+      else
+        self.thumbnail_url = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @id.nil?
+        invalid_properties.push('invalid value for "id", id cannot be nil.')
+      end
+
+      if @title.nil?
+        invalid_properties.push('invalid value for "title", title cannot be nil.')
+      end
+
+      if @description.nil?
+        invalid_properties.push('invalid value for "description", description cannot be nil.')
+      end
+
+      if @privacy.nil?
+        invalid_properties.push('invalid value for "privacy", privacy cannot be nil.')
+      end
+
+      if @item_count.nil?
+        invalid_properties.push('invalid value for "item_count", item_count cannot be nil.')
+      end
+
+      if @thumbnail_url.nil?
+        invalid_properties.push('invalid value for "thumbnail_url", thumbnail_url cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @id.nil?
+      return false if @title.nil?
+      return false if @description.nil?
+      return false if @privacy.nil?
+      privacy_validator = EnumAttributeValidator.new('String', ["private", "public", "unlisted"])
+      return false unless privacy_validator.valid?(@privacy)
+      return false if @item_count.nil?
+      return false if @thumbnail_url.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] id Value to be assigned
+    def id=(id)
+      if id.nil?
+        fail ArgumentError, 'id cannot be nil'
+      end
+
+      @id = id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] title Value to be assigned
+    def title=(title)
+      if title.nil?
+        fail ArgumentError, 'title cannot be nil'
+      end
+
+      @title = title
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] description Value to be assigned
+    def description=(description)
+      if description.nil?
+        fail ArgumentError, 'description cannot be nil'
+      end
+
+      @description = description
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] privacy Object to be assigned
+    def privacy=(privacy)
+      validator = EnumAttributeValidator.new('String', ["private", "public", "unlisted"])
+      unless validator.valid?(privacy)
+        fail ArgumentError, "invalid value for \"privacy\", must be one of #{validator.allowable_values}."
+      end
+      @privacy = privacy
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] item_count Value to be assigned
+    def item_count=(item_count)
+      if item_count.nil?
+        fail ArgumentError, 'item_count cannot be nil'
+      end
+
+      @item_count = item_count
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] thumbnail_url Value to be assigned
+    def thumbnail_url=(thumbnail_url)
+      if thumbnail_url.nil?
+        fail ArgumentError, 'thumbnail_url cannot be nil'
+      end
+
+      @thumbnail_url = thumbnail_url
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          id == o.id &&
+          title == o.title &&
+          description == o.description &&
+          privacy == o.privacy &&
+          item_count == o.item_count &&
+          thumbnail_url == o.thumbnail_url
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [id, title, description, privacy, item_count, thumbnail_url].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/zernio-sdk/models/create_youtube_playlist_request.rb

@@ -0,0 +1,229 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api  Versioning and deprecation: all endpoints are versioned in the URL path (current version: /v1). Breaking changes only ship in a new path version; existing versions keep working. Deprecated operations are marked 'deprecated: true' in this spec and announced in the changelog (https://zernio.com/changelog) before removal.  Errors: every 4xx/5xx response is application/json with a machine-readable 'code' and a human-readable 'error' message (see the ErrorResponse schema). 
+
+The version of the OpenAPI document: 1.0.4
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Zernio
+  class CreateYoutubePlaylistRequest < ApiModelBase
+    # Playlist title. Leading and trailing whitespace is removed.
+    attr_accessor :title
+
+    # Optional playlist description.
+    attr_accessor :description
+
+    attr_accessor :privacy
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'title' => :'title',
+        :'description' => :'description',
+        :'privacy' => :'privacy'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'title' => :'String',
+        :'description' => :'String',
+        :'privacy' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::CreateYoutubePlaylistRequest` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::CreateYoutubePlaylistRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'title')
+        self.title = attributes[:'title']
+      else
+        self.title = nil
+      end
+
+      if attributes.key?(:'description')
+        self.description = attributes[:'description']
+      end
+
+      if attributes.key?(:'privacy')
+        self.privacy = attributes[:'privacy']
+      else
+        self.privacy = 'private'
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @title.nil?
+        invalid_properties.push('invalid value for "title", title cannot be nil.')
+      end
+
+      if @title.to_s.length < 1
+        invalid_properties.push('invalid value for "title", the character length must be greater than or equal to 1.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @title.nil?
+      return false if @title.to_s.length < 1
+      privacy_validator = EnumAttributeValidator.new('String', ["private", "public", "unlisted"])
+      return false unless privacy_validator.valid?(@privacy)
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] title Value to be assigned
+    def title=(title)
+      if title.nil?
+        fail ArgumentError, 'title cannot be nil'
+      end
+
+      if title.to_s.length < 1
+        fail ArgumentError, 'invalid value for "title", the character length must be greater than or equal to 1.'
+      end
+
+      @title = title
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] privacy Object to be assigned
+    def privacy=(privacy)
+      validator = EnumAttributeValidator.new('String', ["private", "public", "unlisted"])
+      unless validator.valid?(privacy)
+        fail ArgumentError, "invalid value for \"privacy\", must be one of #{validator.allowable_values}."
+      end
+      @privacy = privacy
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          title == o.title &&
+          description == o.description &&
+          privacy == o.privacy
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [title, description, privacy].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.938'
+  VERSION = '0.0.939'
 end

data/lib/zernio-sdk.rb

@@ -445,6 +445,9 @@ require 'zernio-sdk/models/create_whats_app_template_request_library_template_bu
 require 'zernio-sdk/models/create_workflow200_response'
 require 'zernio-sdk/models/create_workflow200_response_workflow'
 require 'zernio-sdk/models/create_workflow_request'
+require 'zernio-sdk/models/create_youtube_playlist201_response'
+require 'zernio-sdk/models/create_youtube_playlist201_response_playlist'
+require 'zernio-sdk/models/create_youtube_playlist_request'
 require 'zernio-sdk/models/crosspost_discord_message200_response'
 require 'zernio-sdk/models/ctwa_ad_request_body'
 require 'zernio-sdk/models/ctwa_ad_request_body_cities_inner'

data/openapi.yaml

@@ -25738,6 +25738,74 @@ paths:
         '400': { description: Not a YouTube account }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '404': { description: Account not found }
+    post:
+      operationId: createYoutubePlaylist
+      x-resource-group: "accounts"
+      tags: [Connect]
+      summary: Create YouTube playlist
+      description: >
+        Creates an empty playlist on the connected YouTube channel. Requires a title;
+        privacy defaults to private. Returns the same playlist shape as the list endpoint.
+        Pass the returned playlist.id as platformSpecificData.playlistId when publishing
+        a video. Does not change the account's default playlist.
+        Requires the youtube or youtube.force-ssl OAuth scope. Costs 50 YouTube quota units.
+        This operation is not idempotent and is not automatically retried: repeating a
+        request can create another playlist, including after a timeout. List playlists
+        before retrying an ambiguous failure. Official series settings are not exposed
+        by YouTube's public API and must be enabled manually in YouTube's desktop playlist settings.
+      parameters:
+        - name: accountId
+          in: path
+          required: true
+          schema: { type: string }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [title]
+              properties:
+                title: { type: string, minLength: 1, description: "Playlist title. Leading and trailing whitespace is removed." }
+                description: { type: string, description: "Optional playlist description." }
+                privacy: { type: string, enum: [private, public, unlisted], default: private }
+            example:
+              title: "Tutorials"
+              description: "Step-by-step video tutorials"
+              privacy: "private"
+      responses:
+        '201':
+          description: Playlist created
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [playlist]
+                properties:
+                  playlist:
+                    type: object
+                    required: [id, title, description, privacy, itemCount, thumbnailUrl]
+                    properties:
+                      id: { type: string }
+                      title: { type: string }
+                      description: { type: string }
+                      privacy: { type: string, enum: [private, public, unlisted] }
+                      itemCount: { type: integer }
+                      thumbnailUrl: { type: string }
+              example:
+                playlist:
+                  id: "PLxxxxxxxxxxxxx"
+                  title: "Tutorials"
+                  description: "Step-by-step video tutorials"
+                  privacy: "private"
+                  itemCount: 0
+                  thumbnailUrl: ""
+        '400': { $ref: '#/components/responses/BadRequest' }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403': { description: "API key lacks access to the account or YouTube denied permission." }
+        '404': { description: "Account not found or inaccessible." }
+        '429': { description: "YouTube rate limit exceeded." }
+        '502': { description: "YouTube request failed. Check existing playlists before retrying, because the playlist may have been created." }
     put:
       x-resource-group: "accounts"
       operationId: updateYoutubeDefaultPlaylist

data/spec/api/connect_api_spec.rb

@@ -215,6 +215,19 @@ describe 'ConnectApi' do
     end
   end
 
+  # unit tests for create_youtube_playlist
+  # Create YouTube playlist
+  # Creates an empty playlist on the connected YouTube channel. Requires a title; privacy defaults to private. Returns the same playlist shape as the list endpoint. Pass the returned playlist.id as platformSpecificData.playlistId when publishing a video. Does not change the account's default playlist. Requires the youtube or youtube.force-ssl OAuth scope. Costs 50 YouTube quota units. This operation is not idempotent and is not automatically retried: repeating a request can create another playlist, including after a timeout. List playlists before retrying an ambiguous failure. Official series settings are not exposed by YouTube's public API and must be enabled manually in YouTube's desktop playlist settings. 
+  # @param account_id 
+  # @param create_youtube_playlist_request 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateYoutubePlaylist201Response]
+  describe 'create_youtube_playlist test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for get_connect_url
   # Get OAuth connect URL
   # Initiate an OAuth connection flow. Returns an authUrl to redirect the user to. Standard flow: Zernio hosts the selection UI, then redirects to your redirect_url. Headless mode (headless=true): user is redirected to your redirect_url with OAuth data for custom UI. Use the platform-specific selection endpoints to complete.  TikTok: every connection now goes through the TikTok for Business app. One TikTok account per profile, so connecting on a profile that already holds one replaces it. Reconnecting the SAME account keeps it and all of its history; authorizing a DIFFERENT TikTok account takes the slot over and permanently deletes the previous account's analytics, inbox and DM history. The two are told apart by the `@handle` stored at the last connect, so an account whose handle has been renamed on TikTok since then reads as a different account. An authorization that leaves out a permission the connected account needs changes nothing at all and comes back as `missing_tiktok_permissions`; connect again and accept every permission on TikTok's screen.