google-apis-drive_v3 0.47.0 → 0.48.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c28aca4b595ccde8726057de66d1578cbf1e5864871f0e01b50044a900a9973
-  data.tar.gz: 76bea9695a0f70dcb6305d4b1399a6d5707ae382f12c777750765fa723b1ff32
+  metadata.gz: 2fb0368b0e13a6689d929b813a0a5f00dc9d63bc1c7b042b22467c12d26bcb31
+  data.tar.gz: de2b901a8a4124bb2e21d0c2c64a4432516b1b3f5b3cc2d85e6ab026df38efe2
 SHA512:
-  metadata.gz: cb359ad3a4dc0eea08ce1f1f7cf1889b1716794fa6ef229cc8924f85317547e35557f06bb0be09997eda20bd2c5759b06589358f3a931024339f2da937238620
-  data.tar.gz: e9a4df98e258cb415e23f019bb087338039d94406e60794b9e169f74cec8278cc245f1e91576655f8c2f8a4ab93ac119cdda08f7004b915904ccdcc2a0a98863
+  metadata.gz: c5b45d0e2b38757945637bab36a9a51a4336ba97df6d510529c7fcfd2874ed6ef8ed498f4d24aec482de87301b0cae80fe6bee5a8eaa9868bd9c6f7d60ba9ccd
+  data.tar.gz: 7e52a3c9ab695681883b731678229a74787511276353dfe6da73c722dabe19b43e32aab10c0997d5c0efbc8772e115b9a40502c493a62c45c4cb85d3d04aac8c

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-drive_v3
 
+### v0.48.0 (2024-01-28)
+
+* Regenerated from discovery document revision 20240123
+* Regenerated using generator version 0.13.1
+
 ### v0.47.0 (2024-01-23)
 
 * Regenerated from discovery document revision 20240110

data/lib/google/apis/drive_v3/classes.rb

@@ -217,6 +217,254 @@ module Google
         end
       end
       
+      # The `apps` resource provides a list of apps that a user has installed, with
+      # information about each app's supported MIME types, file extensions, and other
+      # details. Some resource methods (such as `apps.get`) require an `appId`. Use
+      # the `apps.list` method to retrieve the ID for an installed application.
+      class App
+        include Google::Apis::Core::Hashable
+      
+        # Whether the app is authorized to access data on the user's Drive.
+        # Corresponds to the JSON property `authorized`
+        # @return [Boolean]
+        attr_accessor :authorized
+        alias_method :authorized?, :authorized
+      
+        # The template URL to create a file with this app in a given folder. The
+        # template contains the `folderId` to be replaced by the folder ID house the new
+        # file.
+        # Corresponds to the JSON property `createInFolderTemplate`
+        # @return [String]
+        attr_accessor :create_in_folder_template
+      
+        # The URL to create a file with this app.
+        # Corresponds to the JSON property `createUrl`
+        # @return [String]
+        attr_accessor :create_url
+      
+        # Whether the app has Drive-wide scope. An app with Drive-wide scope can access
+        # all files in the user's Drive.
+        # Corresponds to the JSON property `hasDriveWideScope`
+        # @return [Boolean]
+        attr_accessor :has_drive_wide_scope
+        alias_method :has_drive_wide_scope?, :has_drive_wide_scope
+      
+        # The various icons for the app.
+        # Corresponds to the JSON property `icons`
+        # @return [Array<Google::Apis::DriveV3::AppIcons>]
+        attr_accessor :icons
+      
+        # The ID of the app.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Whether the app is installed.
+        # Corresponds to the JSON property `installed`
+        # @return [Boolean]
+        attr_accessor :installed
+        alias_method :installed?, :installed
+      
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # "drive#app".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # A long description of the app.
+        # Corresponds to the JSON property `longDescription`
+        # @return [String]
+        attr_accessor :long_description
+      
+        # The name of the app.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The type of object this app creates such as a Chart. If empty, the app name
+        # should be used instead.
+        # Corresponds to the JSON property `objectType`
+        # @return [String]
+        attr_accessor :object_type
+      
+        # The template URL for opening files with this app. The template contains `ids`
+        # or `exportIds` to be replaced by the actual file IDs. For more information,
+        # see Open Files for the full documentation.
+        # Corresponds to the JSON property `openUrlTemplate`
+        # @return [String]
+        attr_accessor :open_url_template
+      
+        # The list of primary file extensions.
+        # Corresponds to the JSON property `primaryFileExtensions`
+        # @return [Array<String>]
+        attr_accessor :primary_file_extensions
+      
+        # The list of primary MIME types.
+        # Corresponds to the JSON property `primaryMimeTypes`
+        # @return [Array<String>]
+        attr_accessor :primary_mime_types
+      
+        # The ID of the product listing for this app.
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+      
+        # A link to the product listing for this app.
+        # Corresponds to the JSON property `productUrl`
+        # @return [String]
+        attr_accessor :product_url
+      
+        # The list of secondary file extensions.
+        # Corresponds to the JSON property `secondaryFileExtensions`
+        # @return [Array<String>]
+        attr_accessor :secondary_file_extensions
+      
+        # The list of secondary MIME types.
+        # Corresponds to the JSON property `secondaryMimeTypes`
+        # @return [Array<String>]
+        attr_accessor :secondary_mime_types
+      
+        # A short description of the app.
+        # Corresponds to the JSON property `shortDescription`
+        # @return [String]
+        attr_accessor :short_description
+      
+        # Whether this app supports creating objects.
+        # Corresponds to the JSON property `supportsCreate`
+        # @return [Boolean]
+        attr_accessor :supports_create
+        alias_method :supports_create?, :supports_create
+      
+        # Whether this app supports importing from Google Docs.
+        # Corresponds to the JSON property `supportsImport`
+        # @return [Boolean]
+        attr_accessor :supports_import
+        alias_method :supports_import?, :supports_import
+      
+        # Whether this app supports opening more than one file.
+        # Corresponds to the JSON property `supportsMultiOpen`
+        # @return [Boolean]
+        attr_accessor :supports_multi_open
+        alias_method :supports_multi_open?, :supports_multi_open
+      
+        # Whether this app supports creating files when offline.
+        # Corresponds to the JSON property `supportsOfflineCreate`
+        # @return [Boolean]
+        attr_accessor :supports_offline_create
+        alias_method :supports_offline_create?, :supports_offline_create
+      
+        # Whether the app is selected as the default handler for the types it supports.
+        # Corresponds to the JSON property `useByDefault`
+        # @return [Boolean]
+        attr_accessor :use_by_default
+        alias_method :use_by_default?, :use_by_default
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @authorized = args[:authorized] if args.key?(:authorized)
+          @create_in_folder_template = args[:create_in_folder_template] if args.key?(:create_in_folder_template)
+          @create_url = args[:create_url] if args.key?(:create_url)
+          @has_drive_wide_scope = args[:has_drive_wide_scope] if args.key?(:has_drive_wide_scope)
+          @icons = args[:icons] if args.key?(:icons)
+          @id = args[:id] if args.key?(:id)
+          @installed = args[:installed] if args.key?(:installed)
+          @kind = args[:kind] if args.key?(:kind)
+          @long_description = args[:long_description] if args.key?(:long_description)
+          @name = args[:name] if args.key?(:name)
+          @object_type = args[:object_type] if args.key?(:object_type)
+          @open_url_template = args[:open_url_template] if args.key?(:open_url_template)
+          @primary_file_extensions = args[:primary_file_extensions] if args.key?(:primary_file_extensions)
+          @primary_mime_types = args[:primary_mime_types] if args.key?(:primary_mime_types)
+          @product_id = args[:product_id] if args.key?(:product_id)
+          @product_url = args[:product_url] if args.key?(:product_url)
+          @secondary_file_extensions = args[:secondary_file_extensions] if args.key?(:secondary_file_extensions)
+          @secondary_mime_types = args[:secondary_mime_types] if args.key?(:secondary_mime_types)
+          @short_description = args[:short_description] if args.key?(:short_description)
+          @supports_create = args[:supports_create] if args.key?(:supports_create)
+          @supports_import = args[:supports_import] if args.key?(:supports_import)
+          @supports_multi_open = args[:supports_multi_open] if args.key?(:supports_multi_open)
+          @supports_offline_create = args[:supports_offline_create] if args.key?(:supports_offline_create)
+          @use_by_default = args[:use_by_default] if args.key?(:use_by_default)
+        end
+      end
+      
+      # 
+      class AppIcons
+        include Google::Apis::Core::Hashable
+      
+        # Category of the icon. Allowed values are: * `application` - The icon for the
+        # application. * `document` - The icon for a file associated with the app. * `
+        # documentShared` - The icon for a shared file associated with the app.
+        # Corresponds to the JSON property `category`
+        # @return [String]
+        attr_accessor :category
+      
+        # URL for the icon.
+        # Corresponds to the JSON property `iconUrl`
+        # @return [String]
+        attr_accessor :icon_url
+      
+        # Size of the icon. Represented as the maximum of the width and height.
+        # Corresponds to the JSON property `size`
+        # @return [Fixnum]
+        attr_accessor :size
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @category = args[:category] if args.key?(:category)
+          @icon_url = args[:icon_url] if args.key?(:icon_url)
+          @size = args[:size] if args.key?(:size)
+        end
+      end
+      
+      # A list of third-party applications which the user has installed or given
+      # access to Google Drive.
+      class AppList
+        include Google::Apis::Core::Hashable
+      
+        # The list of app IDs that the user has specified to use by default. The list is
+        # in reverse-priority order (lowest to highest).
+        # Corresponds to the JSON property `defaultAppIds`
+        # @return [Array<String>]
+        attr_accessor :default_app_ids
+      
+        # The list of apps.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::DriveV3::App>]
+        attr_accessor :items
+      
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # "drive#appList".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # A link back to this list.
+        # Corresponds to the JSON property `selfLink`
+        # @return [String]
+        attr_accessor :self_link
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @default_app_ids = args[:default_app_ids] if args.key?(:default_app_ids)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @self_link = args[:self_link] if args.key?(:self_link)
+        end
+      end
+      
       # A change to a file or shared drive.
       class Change
         include Google::Apis::Core::Hashable

data/lib/google/apis/drive_v3/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DriveV3
       # Version of the google-apis-drive_v3 gem
-      GEM_VERSION = "0.47.0"
+      GEM_VERSION = "0.48.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.13.0"
+      GENERATOR_VERSION = "0.13.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240110"
+      REVISION = "20240123"
     end
   end
 end

data/lib/google/apis/drive_v3/representations.rb

@@ -46,6 +46,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class App
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AppIcons
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AppList
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Change
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -381,6 +399,57 @@ module Google
         end
       end
       
+      class App
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :authorized, as: 'authorized'
+          property :create_in_folder_template, as: 'createInFolderTemplate'
+          property :create_url, as: 'createUrl'
+          property :has_drive_wide_scope, as: 'hasDriveWideScope'
+          collection :icons, as: 'icons', class: Google::Apis::DriveV3::AppIcons, decorator: Google::Apis::DriveV3::AppIcons::Representation
+      
+          property :id, as: 'id'
+          property :installed, as: 'installed'
+          property :kind, as: 'kind'
+          property :long_description, as: 'longDescription'
+          property :name, as: 'name'
+          property :object_type, as: 'objectType'
+          property :open_url_template, as: 'openUrlTemplate'
+          collection :primary_file_extensions, as: 'primaryFileExtensions'
+          collection :primary_mime_types, as: 'primaryMimeTypes'
+          property :product_id, as: 'productId'
+          property :product_url, as: 'productUrl'
+          collection :secondary_file_extensions, as: 'secondaryFileExtensions'
+          collection :secondary_mime_types, as: 'secondaryMimeTypes'
+          property :short_description, as: 'shortDescription'
+          property :supports_create, as: 'supportsCreate'
+          property :supports_import, as: 'supportsImport'
+          property :supports_multi_open, as: 'supportsMultiOpen'
+          property :supports_offline_create, as: 'supportsOfflineCreate'
+          property :use_by_default, as: 'useByDefault'
+        end
+      end
+      
+      class AppIcons
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :category, as: 'category'
+          property :icon_url, as: 'iconUrl'
+          property :size, as: 'size'
+        end
+      end
+      
+      class AppList
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :default_app_ids, as: 'defaultAppIds'
+          collection :items, as: 'items', class: Google::Apis::DriveV3::App, decorator: Google::Apis::DriveV3::App::Representation
+      
+          property :kind, as: 'kind'
+          property :self_link, as: 'selfLink'
+        end
+      end
+      
       class Change
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/drive_v3/service.rb

@@ -78,6 +78,79 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets a specific app.
+        # @param [String] app_id
+        #   The ID of the app.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DriveV3::App] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::App]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_app(app_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'apps/{appId}', options)
+          command.response_representation = Google::Apis::DriveV3::App::Representation
+          command.response_class = Google::Apis::DriveV3::App
+          command.params['appId'] = app_id unless app_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists a user's installed apps.
+        # @param [String] app_filter_extensions
+        #   A comma-separated list of file extensions to limit returned results. All
+        #   results within the given app query scope which can open any of the given file
+        #   extensions are included in the response. If `appFilterMimeTypes` are provided
+        #   as well, the result is a union of the two resulting app lists.
+        # @param [String] app_filter_mime_types
+        #   A comma-separated list of file extensions to limit returned results. All
+        #   results within the given app query scope which can open any of the given MIME
+        #   types will be included in the response. If `appFilterExtensions` are provided
+        #   as well, the result is a union of the two resulting app lists.
+        # @param [String] language_code
+        #   A language or locale code, as defined by BCP 47, with some extensions from
+        #   Unicode's LDML format (http://www.unicode.org/reports/tr35/).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DriveV3::AppList] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DriveV3::AppList]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_apps(app_filter_extensions: nil, app_filter_mime_types: nil, language_code: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'apps', options)
+          command.response_representation = Google::Apis::DriveV3::AppList::Representation
+          command.response_class = Google::Apis::DriveV3::AppList
+          command.query['appFilterExtensions'] = app_filter_extensions unless app_filter_extensions.nil?
+          command.query['appFilterMimeTypes'] = app_filter_mime_types unless app_filter_mime_types.nil?
+          command.query['languageCode'] = language_code unless language_code.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the starting pageToken for listing future changes.
         # @param [String] drive_id
         #   The ID of the shared drive for which the starting pageToken for listing future

data/lib/google/apis/drive_v3.rb

@@ -35,6 +35,9 @@ module Google
       # See, create, and delete its own configuration data in your Google Drive
       AUTH_DRIVE_APPDATA = 'https://www.googleapis.com/auth/drive.appdata'
 
+      # View your Google Drive apps
+      AUTH_DRIVE_APPS_READONLY = 'https://www.googleapis.com/auth/drive.apps.readonly'
+
       # See, edit, create, and delete only the specific Google Drive files you use with this app
       AUTH_DRIVE_FILE = 'https://www.googleapis.com/auth/drive.file'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-drive_v3
 version: !ruby/object:Gem::Version
-  version: 0.47.0
+  version: 0.48.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-23 00:00:00.000000000 Z
+date: 2024-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.47.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-drive_v3/v0.48.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-drive_v3
 post_install_message: 
 rdoc_options: []