google-apis-androidmanagement_v1 0.34.0 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd71b87c499079ae6f1939ca1cd362ed1aa8dd9244aa97cf9ae17fa0df73a084
-  data.tar.gz: 19bd8485a77e28559d0b5e6b005aedc8d0aa501cb90a8905f206a8e189d1a288
+  metadata.gz: 9bc26376706f5afc29e098ccb309f7f4ba4f6addd08f435bed538792fd5c06f0
+  data.tar.gz: ed4dabe0ae76abf321a6e3ebb023506fc2309f20b40aa6645363ca177db39693
 SHA512:
-  metadata.gz: 3ed961b0ba4f2c72fcae5576ea910750b477c111cb0febfe2da9201ca380eef5e3e55ca8b266d3a54218b3e611d24e30326cc5e75662762c3086de1c8e5ead48
-  data.tar.gz: ad1785013b3a6fc3abec20441a079feb478ca44ecba5558ab2670099b75b1dec22a89861fdbb450551aaa509f611d78e38c26b4c1c4fec498eeff75d6d5cd487
+  metadata.gz: 75bbab508168acc3408788247c7d1fa1cb48852269fe74879b5d8f3007d235da755b0517bdf1901587b38f5f4d666a15a90e248d6692dcf918419350e5aeada0
+  data.tar.gz: 1c1cb5bcfe0d710b8a22773122529277ef19ca9eeb71404d8e96dee5d3e56e5a44054a3254eb9839c0d13ad36332935013bdb7dc408db3f58583db9379588063

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-androidmanagement_v1
 
+### v0.35.0 (2022-06-08)
+
+* Regenerated from discovery document revision 20220601
+
 ### v0.34.0 (2022-06-05)
 
 * Regenerated using generator version 0.5.0

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

@@ -735,10 +735,64 @@ module Google
         end
       end
       
+      # Parameters associated with the CLEAR_APP_DATA command to clear the data of
+      # specified apps from the device.
+      class ClearAppsDataParams
+        include Google::Apis::Core::Hashable
+      
+        # The package names of the apps whose data will be cleared when the command is
+        # executed.
+        # Corresponds to the JSON property `packageNames`
+        # @return [Array<String>]
+        attr_accessor :package_names
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @package_names = args[:package_names] if args.key?(:package_names)
+        end
+      end
+      
+      # Status of the CLEAR_APP_DATA command to clear the data of specified apps from
+      # the device.
+      class ClearAppsDataStatus
+        include Google::Apis::Core::Hashable
+      
+        # The per-app results, a mapping from package names to the respective clearing
+        # result.
+        # Corresponds to the JSON property `results`
+        # @return [Hash<String,Google::Apis::AndroidmanagementV1::PerAppResult>]
+        attr_accessor :results
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @results = args[:results] if args.key?(:results)
+        end
+      end
+      
       # A command.
       class Command
         include Google::Apis::Core::Hashable
       
+        # Parameters associated with the CLEAR_APP_DATA command to clear the data of
+        # specified apps from the device.
+        # Corresponds to the JSON property `clearAppsDataParams`
+        # @return [Google::Apis::AndroidmanagementV1::ClearAppsDataParams]
+        attr_accessor :clear_apps_data_params
+      
+        # Status of the CLEAR_APP_DATA command to clear the data of specified apps from
+        # the device.
+        # Corresponds to the JSON property `clearAppsDataStatus`
+        # @return [Google::Apis::AndroidmanagementV1::ClearAppsDataStatus]
+        attr_accessor :clear_apps_data_status
+      
         # The timestamp at which the command was created. The timestamp is automatically
         # generated by the server.
         # Corresponds to the JSON property `createTime`
@@ -786,6 +840,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @clear_apps_data_params = args[:clear_apps_data_params] if args.key?(:clear_apps_data_params)
+          @clear_apps_data_status = args[:clear_apps_data_status] if args.key?(:clear_apps_data_status)
           @create_time = args[:create_time] if args.key?(:create_time)
           @duration = args[:duration] if args.key?(:duration)
           @error_code = args[:error_code] if args.key?(:error_code)
@@ -2058,6 +2114,31 @@ module Google
         end
       end
       
+      # Response to a request to list enrollment tokens for a given enterprise.
+      class ListEnrollmentTokensResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of enrollment tokens.
+        # Corresponds to the JSON property `enrollmentTokens`
+        # @return [Array<Google::Apis::AndroidmanagementV1::EnrollmentToken>]
+        attr_accessor :enrollment_tokens
+      
+        # If there are more results, a token to retrieve next page of results.
+        # 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)
+          @enrollment_tokens = args[:enrollment_tokens] if args.key?(:enrollment_tokens)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Response to a request to list enterprises.
       class ListEnterprisesResponse
         include Google::Apis::Core::Hashable
@@ -2415,6 +2496,16 @@ module Google
         # @return [String]
         attr_accessor :setting_name
       
+        # Additional context for SpecificNonComplianceReason.
+        # Corresponds to the JSON property `specificNonComplianceContext`
+        # @return [Google::Apis::AndroidmanagementV1::SpecificNonComplianceContext]
+        attr_accessor :specific_non_compliance_context
+      
+        # The policy-specific reason the device is not in compliance with the setting.
+        # Corresponds to the JSON property `specificNonComplianceReason`
+        # @return [String]
+        attr_accessor :specific_non_compliance_reason
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2427,6 +2518,8 @@ module Google
           @non_compliance_reason = args[:non_compliance_reason] if args.key?(:non_compliance_reason)
           @package_name = args[:package_name] if args.key?(:package_name)
           @setting_name = args[:setting_name] if args.key?(:setting_name)
+          @specific_non_compliance_context = args[:specific_non_compliance_context] if args.key?(:specific_non_compliance_context)
+          @specific_non_compliance_reason = args[:specific_non_compliance_reason] if args.key?(:specific_non_compliance_reason)
         end
       end
       
@@ -2493,6 +2586,25 @@ module Google
         end
       end
       
+      # Additional context for non-compliance related to Wi-Fi configuration.
+      class OncWifiContext
+        include Google::Apis::Core::Hashable
+      
+        # The GUID of non-compliant Wi-Fi configuration.
+        # Corresponds to the JSON property `wifiGuid`
+        # @return [String]
+        attr_accessor :wifi_guid
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @wifi_guid = args[:wifi_guid] if args.key?(:wifi_guid)
+        end
+      end
+      
       # This resource represents a long-running operation that is the result of a
       # network API call.
       class Operation
@@ -2574,6 +2686,25 @@ module Google
         end
       end
       
+      # Additional context for non-compliance related to password policies.
+      class PasswordPoliciesContext
+        include Google::Apis::Core::Hashable
+      
+        # The scope of non-compliant password.
+        # Corresponds to the JSON property `passwordPolicyScope`
+        # @return [String]
+        attr_accessor :password_policy_scope
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @password_policy_scope = args[:password_policy_scope] if args.key?(:password_policy_scope)
+        end
+      end
+      
       # Requirements for the password used to unlock a device.
       class PasswordRequirements
         include Google::Apis::Core::Hashable
@@ -2691,6 +2822,25 @@ module Google
         end
       end
       
+      # The result of an attempt to clear the data of a single app.
+      class PerAppResult
+        include Google::Apis::Core::Hashable
+      
+        # The result of an attempt to clear the data of a single app.
+        # Corresponds to the JSON property `clearingResult`
+        # @return [String]
+        attr_accessor :clearing_result
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @clearing_result = args[:clearing_result] if args.key?(:clearing_result)
+        end
+      end
+      
       # Configuration for an Android permission and its grant state.
       class PermissionGrant
         include Google::Apis::Core::Hashable
@@ -3856,6 +4006,31 @@ module Google
         end
       end
       
+      # Additional context for SpecificNonComplianceReason.
+      class SpecificNonComplianceContext
+        include Google::Apis::Core::Hashable
+      
+        # Additional context for non-compliance related to Wi-Fi configuration.
+        # Corresponds to the JSON property `oncWifiContext`
+        # @return [Google::Apis::AndroidmanagementV1::OncWifiContext]
+        attr_accessor :onc_wifi_context
+      
+        # Additional context for non-compliance related to password policies.
+        # Corresponds to the JSON property `passwordPoliciesContext`
+        # @return [Google::Apis::AndroidmanagementV1::PasswordPoliciesContext]
+        attr_accessor :password_policies_context
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @onc_wifi_context = args[:onc_wifi_context] if args.key?(:onc_wifi_context)
+          @password_policies_context = args[:password_policies_context] if args.key?(:password_policies_context)
+        end
+      end
+      
       # The Status type defines a logical error model that is suitable for different
       # programming environments, including REST APIs and RPC APIs. It is used by gRPC
       # (https://github.com/grpc). Each Status message contains three pieces of data:

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.34.0"
+      GEM_VERSION = "0.35.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.5.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220524"
+      REVISION = "20220601"
     end
   end
 end

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

@@ -100,6 +100,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ClearAppsDataParams
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ClearAppsDataStatus
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Command
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -238,6 +250,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListEnrollmentTokensResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListEnterprisesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -316,6 +334,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class OncWifiContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -328,12 +352,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PasswordPoliciesContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PasswordRequirements
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PerAppResult
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PermissionGrant
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -418,6 +454,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SpecificNonComplianceContext
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Status
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -656,9 +698,28 @@ module Google
         end
       end
       
+      class ClearAppsDataParams
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :package_names, as: 'packageNames'
+        end
+      end
+      
+      class ClearAppsDataStatus
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :results, as: 'results', class: Google::Apis::AndroidmanagementV1::PerAppResult, decorator: Google::Apis::AndroidmanagementV1::PerAppResult::Representation
+      
+        end
+      end
+      
       class Command
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :clear_apps_data_params, as: 'clearAppsDataParams', class: Google::Apis::AndroidmanagementV1::ClearAppsDataParams, decorator: Google::Apis::AndroidmanagementV1::ClearAppsDataParams::Representation
+      
+          property :clear_apps_data_status, as: 'clearAppsDataStatus', class: Google::Apis::AndroidmanagementV1::ClearAppsDataStatus, decorator: Google::Apis::AndroidmanagementV1::ClearAppsDataStatus::Representation
+      
           property :create_time, as: 'createTime'
           property :duration, as: 'duration'
           property :error_code, as: 'errorCode'
@@ -959,6 +1020,15 @@ module Google
         end
       end
       
+      class ListEnrollmentTokensResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :enrollment_tokens, as: 'enrollmentTokens', class: Google::Apis::AndroidmanagementV1::EnrollmentToken, decorator: Google::Apis::AndroidmanagementV1::EnrollmentToken::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListEnterprisesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1064,6 +1134,9 @@ module Google
           property :non_compliance_reason, as: 'nonComplianceReason'
           property :package_name, as: 'packageName'
           property :setting_name, as: 'settingName'
+          property :specific_non_compliance_context, as: 'specificNonComplianceContext', class: Google::Apis::AndroidmanagementV1::SpecificNonComplianceContext, decorator: Google::Apis::AndroidmanagementV1::SpecificNonComplianceContext::Representation
+      
+          property :specific_non_compliance_reason, as: 'specificNonComplianceReason'
         end
       end
       
@@ -1085,6 +1158,13 @@ module Google
         end
       end
       
+      class OncWifiContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :wifi_guid, as: 'wifiGuid'
+        end
+      end
+      
       class Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1104,6 +1184,13 @@ module Google
         end
       end
       
+      class PasswordPoliciesContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :password_policy_scope, as: 'passwordPolicyScope'
+        end
+      end
+      
       class PasswordRequirements
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1124,6 +1211,13 @@ module Google
         end
       end
       
+      class PerAppResult
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :clearing_result, as: 'clearingResult'
+        end
+      end
+      
       class PermissionGrant
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1376,6 +1470,16 @@ module Google
         end
       end
       
+      class SpecificNonComplianceContext
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :onc_wifi_context, as: 'oncWifiContext', class: Google::Apis::AndroidmanagementV1::OncWifiContext, decorator: Google::Apis::AndroidmanagementV1::OncWifiContext::Representation
+      
+          property :password_policies_context, as: 'passwordPoliciesContext', class: Google::Apis::AndroidmanagementV1::PasswordPoliciesContext, decorator: Google::Apis::AndroidmanagementV1::PasswordPoliciesContext::Representation
+      
+        end
+      end
+      
       class Status
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -606,7 +606,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an enrollment token for a given enterprise.
+        # Creates an enrollment token for a given enterprise. It's up to the caller's
+        # responsibility to manage the lifecycle of newly created tokens and deleting
+        # them when they're not intended to be used anymore. Once an enrollment token
+        # has been created, it's not possible to retrieve the token's content anymore
+        # using AM API. It is recommended for EMMs to securely store the token if it's
+        # intended to be reused.
         # @param [String] parent
         #   The name of the enterprise in the form enterprises/`enterpriseId`.
         # @param [Google::Apis::AndroidmanagementV1::EnrollmentToken] enrollment_token_object
@@ -671,6 +676,83 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets an active, unexpired enrollment token. Only a partial view of
+        # EnrollmentToken is returned: all the fields but name and expiration_timestamp
+        # are empty. This method is meant to help manage active enrollment tokens
+        # lifecycle. For security reasons, it's recommended to delete active enrollment
+        # tokens as soon as they're not intended to be used anymore.
+        # @param [String] name
+        #   Required. The name of the enrollment token in the form enterprises/`
+        #   enterpriseId`/enrollmentTokens/`enrollmentTokenId`.
+        # @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::EnrollmentToken] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidmanagementV1::EnrollmentToken]
+        #
+        # @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_enrollment_token(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::AndroidmanagementV1::EnrollmentToken::Representation
+          command.response_class = Google::Apis::AndroidmanagementV1::EnrollmentToken
+          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 active, unexpired enrollment tokens for a given enterprise. The list
+        # items contain only a partial view of EnrollmentToken: all the fields but name
+        # and expiration_timestamp are empty. This method is meant to help manage active
+        # enrollment tokens lifecycle. For security reasons, it's recommended to delete
+        # active enrollment tokens as soon as they're not intended to be used anymore.
+        # @param [String] parent
+        #   Required. The name of the enterprise in the form enterprises/`enterpriseId`.
+        # @param [Fixnum] page_size
+        #   The requested page size. The service may return fewer than this value. If
+        #   unspecified, at most 10 items will be returned. The maximum value is 100;
+        #   values above 100 will be coerced to 100.
+        # @param [String] page_token
+        #   A token identifying a page of results returned by the server.
+        # @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::ListEnrollmentTokensResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidmanagementV1::ListEnrollmentTokensResponse]
+        #
+        # @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_enrollment_tokens(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/enrollmentTokens', options)
+          command.response_representation = Google::Apis::AndroidmanagementV1::ListEnrollmentTokensResponse::Representation
+          command.response_class = Google::Apis::AndroidmanagementV1::ListEnrollmentTokensResponse
+          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.34.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-06 00:00:00.000000000 Z
+date: 2022-06-13 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.34.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-androidmanagement_v1/v0.35.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-androidmanagement_v1
 post_install_message: 
 rdoc_options: []