google-apis-androidmanagement_v1 0.67.0 → 0.68.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 902beb864415a5a09bc850df180821da8ab81518a94504b7169e94005e98d1d0
-  data.tar.gz: 269f677f79913a140fea9fa021cb4fa47fb7436ee3edf133c2dce7e79edd0f79
+  metadata.gz: 3f4ea2aeb2ba8b772cc58f35147597565b8cc411685624202c36e4f358799507
+  data.tar.gz: c2424af77e6ec9d38c21dbc3ac5425c2b9fd9ea7ada0d5a45f3a848891f7e846
 SHA512:
-  metadata.gz: 5079ddae62769a989d47561bed65ede4e8424e19a181d47abcb753e7c0ec383fbfac1e9b954f505cad312548f2f93b3b34f8b9d6773b7cbc8d3f9edc4f76d829
-  data.tar.gz: a0eb7fdf0ed88dc3826feecb20ae664d02fa20469cf0dd66add7e2e480f833e9b95f99a69026f5d805185bfe7fc91e5889c26cf45dae784ee1458905bb3458c9
+  metadata.gz: 21b8cf3c60eaa96552a96321358d6b3d4a3749bbf4cd6d5f6cf0703a103a3347257d6ed588dfba5314b7c511862999283705f76b1ce137f1e9ea198db379d510
+  data.tar.gz: de9627a7abeafbdc05ea06113772045686a5ae45d7991ceaa10ef1553a4ee17d6527440a66158f5fe3b5325a8048121440b67e0866df8737a70c994679093252

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-androidmanagement_v1
 
+### v0.68.0 (2024-01-28)
+
+* Regenerated from discovery document revision 20240115
+* Regenerated using generator version 0.13.1
+
 ### v0.67.0 (2024-01-22)
 
 * Regenerated from discovery document revision 20240108

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

@@ -1527,6 +1527,12 @@ module Google
         # @return [Array<Google::Apis::AndroidmanagementV1::DisplayProp>]
         attr_accessor :displays
       
+        # Information related to whether this device was migrated from being managed by
+        # another Device Policy Controller (DPC).
+        # Corresponds to the JSON property `dpcMigrationInfo`
+        # @return [Google::Apis::AndroidmanagementV1::DpcMigrationInfo]
+        attr_accessor :dpc_migration_info
+      
         # The time of device enrollment.
         # Corresponds to the JSON property `enrollmentTime`
         # @return [String]
@@ -1695,6 +1701,7 @@ module Google
           @device_settings = args[:device_settings] if args.key?(:device_settings)
           @disabled_reason = args[:disabled_reason] if args.key?(:disabled_reason)
           @displays = args[:displays] if args.key?(:displays)
+          @dpc_migration_info = args[:dpc_migration_info] if args.key?(:dpc_migration_info)
           @enrollment_time = args[:enrollment_time] if args.key?(:enrollment_time)
           @enrollment_token_data = args[:enrollment_token_data] if args.key?(:enrollment_token_data)
           @enrollment_token_name = args[:enrollment_token_name] if args.key?(:enrollment_token_name)
@@ -1967,6 +1974,34 @@ module Google
         end
       end
       
+      # Information related to whether this device was migrated from being managed by
+      # another Device Policy Controller (DPC).
+      class DpcMigrationInfo
+        include Google::Apis::Core::Hashable
+      
+        # Output only. If this device was migrated from another DPC, the additionalData
+        # field of the migration token is populated here.
+        # Corresponds to the JSON property `additionalData`
+        # @return [String]
+        attr_accessor :additional_data
+      
+        # Output only. If this device was migrated from another DPC, this is its package
+        # name. Not populated otherwise.
+        # Corresponds to the JSON property `previousDpc`
+        # @return [String]
+        attr_accessor :previous_dpc
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @additional_data = args[:additional_data] if args.key?(:additional_data)
+          @previous_dpc = args[:previous_dpc] if args.key?(:previous_dpc)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -2915,6 +2950,32 @@ module Google
         end
       end
       
+      # Response to a request to list migration tokens for a given enterprise.
+      class ListMigrationTokensResponse
+        include Google::Apis::Core::Hashable
+      
+        # The migration tokens from the specified enterprise.
+        # Corresponds to the JSON property `migrationTokens`
+        # @return [Array<Google::Apis::AndroidmanagementV1::MigrationToken>]
+        attr_accessor :migration_tokens
+      
+        # A token, which can be sent as page_token to retrieve the next page. If this
+        # field is omitted, there are no subsequent pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @migration_tokens = args[:migration_tokens] if args.key?(:migration_tokens)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # The response message for Operations.ListOperations.
       class ListOperationsResponse
         include Google::Apis::Core::Hashable
@@ -3316,6 +3377,105 @@ module Google
         end
       end
       
+      # A token to initiate the migration of a device from being managed by a third-
+      # party DPC to being managed by Android Management API. A migration token is
+      # valid only for a single device.
+      class MigrationToken
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. Optional EMM-specified additional data. Once the device is migrated
+        # this will be populated in the migrationAdditionalData field of the Device
+        # resource. This must be at most 1024 characters.
+        # Corresponds to the JSON property `additionalData`
+        # @return [String]
+        attr_accessor :additional_data
+      
+        # Output only. Time when this migration token was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Output only. Once this migration token is used to migrate a device, the name
+        # of the resulting Device resource will be populated here, in the form
+        # enterprises/`enterprise`/devices/`device`.
+        # Corresponds to the JSON property `device`
+        # @return [String]
+        attr_accessor :device
+      
+        # Required. Immutable. The id of the device, as in the Play EMM API. This
+        # corresponds to the deviceId parameter in Play EMM API's Devices.get (https://
+        # developers.google.com/android/work/play/emm-api/v1/devices/get#parameters)
+        # call.
+        # Corresponds to the JSON property `deviceId`
+        # @return [String]
+        attr_accessor :device_id
+      
+        # Immutable. The time when this migration token expires. This can be at most
+        # seven days from the time of creation. The migration token is deleted seven
+        # days after it expires.
+        # Corresponds to the JSON property `expireTime`
+        # @return [String]
+        attr_accessor :expire_time
+      
+        # Required. Immutable. The management mode of the device or profile being
+        # migrated.
+        # Corresponds to the JSON property `managementMode`
+        # @return [String]
+        attr_accessor :management_mode
+      
+        # Output only. The name of the migration token, which is generated by the server
+        # during creation, in the form enterprises/`enterprise`/migrationTokens/`
+        # migration_token`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Required. Immutable. The name of the policy initially applied to the enrolled
+        # device, in the form enterprises/`enterprise`/policies/`policy`.
+        # Corresponds to the JSON property `policy`
+        # @return [String]
+        attr_accessor :policy
+      
+        # Input only. The time that this migration token is valid for. This is input-
+        # only, and for returning a migration token the server will populate the
+        # expireTime field. This can be at most seven days. The default is seven days.
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        # Required. Immutable. The user id of the Managed Google Play account on the
+        # device, as in the Play EMM API. This corresponds to the userId parameter in
+        # Play EMM API's Devices.get (https://developers.google.com/android/work/play/
+        # emm-api/v1/devices/get#parameters) call.
+        # Corresponds to the JSON property `userId`
+        # @return [String]
+        attr_accessor :user_id
+      
+        # Output only. The value of the migration token.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @additional_data = args[:additional_data] if args.key?(:additional_data)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @device = args[:device] if args.key?(:device)
+          @device_id = args[:device_id] if args.key?(:device_id)
+          @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @management_mode = args[:management_mode] if args.key?(:management_mode)
+          @name = args[:name] if args.key?(:name)
+          @policy = args[:policy] if args.key?(:policy)
+          @ttl = args[:ttl] if args.key?(:ttl)
+          @user_id = args[:user_id] if args.key?(:user_id)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # Device network info.
       class NetworkInfo
         include Google::Apis::Core::Hashable

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module AndroidmanagementV1
       # Version of the google-apis-androidmanagement_v1 gem
-      GEM_VERSION = "0.67.0"
+      GEM_VERSION = "0.68.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 = "20240108"
+      REVISION = "20240115"
     end
   end
 end

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

@@ -250,6 +250,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DpcMigrationInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -400,6 +406,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListMigrationTokensResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListOperationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -496,6 +508,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MigrationToken
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class NetworkInfo
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1159,6 +1177,8 @@ module Google
       
           collection :displays, as: 'displays', class: Google::Apis::AndroidmanagementV1::DisplayProp, decorator: Google::Apis::AndroidmanagementV1::DisplayProp::Representation
       
+          property :dpc_migration_info, as: 'dpcMigrationInfo', class: Google::Apis::AndroidmanagementV1::DpcMigrationInfo, decorator: Google::Apis::AndroidmanagementV1::DpcMigrationInfo::Representation
+      
           property :enrollment_time, as: 'enrollmentTime'
           property :enrollment_token_data, as: 'enrollmentTokenData'
           property :enrollment_token_name, as: 'enrollmentTokenName'
@@ -1254,6 +1274,14 @@ module Google
         end
       end
       
+      class DpcMigrationInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :additional_data, as: 'additionalData'
+          property :previous_dpc, as: 'previousDpc'
+        end
+      end
+      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1495,6 +1523,15 @@ module Google
         end
       end
       
+      class ListMigrationTokensResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :migration_tokens, as: 'migrationTokens', class: Google::Apis::AndroidmanagementV1::MigrationToken, decorator: Google::Apis::AndroidmanagementV1::MigrationToken::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListOperationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1627,6 +1664,23 @@ module Google
         end
       end
       
+      class MigrationToken
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :additional_data, as: 'additionalData'
+          property :create_time, as: 'createTime'
+          property :device, as: 'device'
+          property :device_id, as: 'deviceId'
+          property :expire_time, as: 'expireTime'
+          property :management_mode, as: 'managementMode'
+          property :name, as: 'name'
+          property :policy, as: 'policy'
+          property :ttl, as: 'ttl'
+          property :user_id, as: 'userId'
+          property :value, as: 'value'
+        end
+      end
+      
       class NetworkInfo
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -753,6 +753,114 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a migration token, to migrate an existing device from being managed by
+        # the EMM's Device Policy Controller (DPC) to being managed by the Android
+        # Management API.
+        # @param [String] parent
+        #   Required. The enterprise in which this migration token will be created. Format:
+        #   enterprises/`enterprise`
+        # @param [Google::Apis::AndroidmanagementV1::MigrationToken] migration_token_object
+        # @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::AndroidmanagementV1::MigrationToken] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidmanagementV1::MigrationToken]
+        #
+        # @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 create_enterprise_migration_token(parent, migration_token_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/migrationTokens', options)
+          command.request_representation = Google::Apis::AndroidmanagementV1::MigrationToken::Representation
+          command.request_object = migration_token_object
+          command.response_representation = Google::Apis::AndroidmanagementV1::MigrationToken::Representation
+          command.response_class = Google::Apis::AndroidmanagementV1::MigrationToken
+          command.params['parent'] = parent unless parent.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 a migration token.
+        # @param [String] name
+        #   Required. The name of the migration token to retrieve. Format: enterprises/`
+        #   enterprise`/migrationTokens/`migration_token`
+        # @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::AndroidmanagementV1::MigrationToken] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidmanagementV1::MigrationToken]
+        #
+        # @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_enterprise_migration_token(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::AndroidmanagementV1::MigrationToken::Representation
+          command.response_class = Google::Apis::AndroidmanagementV1::MigrationToken
+          command.params['name'] = name unless name.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 migration tokens.
+        # @param [String] parent
+        #   Required. The enterprise which the migration tokens belong to. Format:
+        #   enterprises/`enterprise`
+        # @param [Fixnum] page_size
+        #   The maximum number of migration tokens to return. Fewer migration tokens may
+        #   be returned. If unspecified, at most 100 migration tokens will be returned.
+        #   The maximum value is 100; values above 100 will be coerced to 100.
+        # @param [String] page_token
+        #   A page token, received from a previous ListMigrationTokens call. Provide this
+        #   to retrieve the subsequent page.When paginating, all other parameters provided
+        #   to ListMigrationTokens must match the call that provided the page token.
+        # @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::AndroidmanagementV1::ListMigrationTokensResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidmanagementV1::ListMigrationTokensResponse]
+        #
+        # @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_enterprise_migration_tokens(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/migrationTokens', options)
+          command.response_representation = Google::Apis::AndroidmanagementV1::ListMigrationTokensResponse::Representation
+          command.response_class = Google::Apis::AndroidmanagementV1::ListMigrationTokensResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Deletes a policy. This operation is only permitted if no devices are currently
         # referencing the policy.
         # @param [String] name

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-androidmanagement_v1
 version: !ruby/object:Gem::Version
-  version: 0.67.0
+  version: 0.68.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-androidmanagement_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-androidmanagement_v1/v0.67.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-androidmanagement_v1/v0.68.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-androidmanagement_v1
 post_install_message: 
 rdoc_options: []