google-api-client 0.9.8 → 0.9.20

data/generated/google/apis/androidenterprise_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/android/work/play/emm-api
     module AndroidenterpriseV1
       VERSION = 'V1'
-      REVISION = '20160519'
+      REVISION = '20161102'
 
       # Manage corporate Android devices
       AUTH_ANDROIDENTERPRISE = 'https://www.googleapis.com/auth/androidenterprise'

data/generated/google/apis/androidenterprise_v1/classes.rb

@@ -22,6 +22,90 @@ module Google
   module Apis
     module AndroidenterpriseV1
       
+      # This represents an enterprise administrator who can manage the enterprise in
+      # the Google Play for Work Store.
+      class Administrator
+        include Google::Apis::Core::Hashable
+      
+        # The administrator's email address.
+        # Corresponds to the JSON property `email`
+        # @return [String]
+        attr_accessor :email
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @email = args[:email] if args.key?(:email)
+        end
+      end
+      
+      # A token authorizing an administrator to access an iframe.
+      class AdministratorWebToken
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#administratorWebToken".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # An opaque token to be passed to the Play front-end to generate an iframe.
+        # Corresponds to the JSON property `token`
+        # @return [String]
+        attr_accessor :token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @token = args[:token] if args.key?(:token)
+        end
+      end
+      
+      # Specification for a token used to generate iframes. The token specifies what
+      # data the admin is allowed to modify and the URI the iframe is allowed to
+      # communiate with.
+      class AdministratorWebTokenSpec
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#administratorWebTokenSpec".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The URI of the parent frame hosting the iframe. To prevent XSS, the iframe may
+        # not be hosted at other URIs. This URI must be https.
+        # Corresponds to the JSON property `parent`
+        # @return [String]
+        attr_accessor :parent
+      
+        # The list of permissions the admin is granted within the iframe. The admin will
+        # only be allowed to view an iframe if they have all of the permissions
+        # associated with it. The only valid value is "approveApps" that will allow the
+        # admin to access the iframe in "approve" mode.
+        # Corresponds to the JSON property `permission`
+        # @return [Array<String>]
+        attr_accessor :permission
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @parent = args[:parent] if args.key?(:parent)
+          @permission = args[:permission] if args.key?(:permission)
+        end
+      end
+      
       # Represents the list of app restrictions available to be pre-configured for the
       # product.
       class AppRestrictionsSchema
@@ -49,6 +133,28 @@ module Google
         end
       end
       
+      # An event generated when a new app version is uploaded to Google Play and its
+      # app restrictions schema changed. To fetch the app restrictions schema for an
+      # app, use Products.getAppRestrictionsSchema on the EMM API.
+      class AppRestrictionsSchemaChangeEvent
+        include Google::Apis::Core::Hashable
+      
+        # The id of the product (e.g. "app:com.google.android.gm") for which the app
+        # restriction schema changed. This field will always be present.
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @product_id = args[:product_id] if args.key?(:product_id)
+        end
+      end
+      
       # A restriction in the App Restriction Schema represents a piece of
       # configuration that may be pre-applied.
       class AppRestrictionsSchemaRestriction
@@ -71,7 +177,9 @@ module Google
         attr_accessor :entry
       
         # For choice or multiselect restrictions, the list of possible entries' machine-
-        # readable values.
+        # readable values. These values should be used in the configuration, either as a
+        # single string value for a choice restriction or in a stringArray for a
+        # multiselect restriction.
         # Corresponds to the JSON property `entryValue`
         # @return [Array<String>]
         attr_accessor :entry_value
@@ -82,6 +190,13 @@ module Google
         # @return [String]
         attr_accessor :key
       
+        # For bundle or bundleArray restrictions, the list of nested restrictions. A
+        # bundle restriction is always nested within a bundleArray restriction, and a
+        # bundleArray restriction is at most two levels deep.
+        # Corresponds to the JSON property `nestedRestriction`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::AppRestrictionsSchemaRestriction>]
+        attr_accessor :nested_restriction
+      
         # The type of the restriction.
         # Corresponds to the JSON property `restrictionType`
         # @return [String]
@@ -103,6 +218,7 @@ module Google
           @entry = args[:entry] if args.key?(:entry)
           @entry_value = args[:entry_value] if args.key?(:entry_value)
           @key = args[:key] if args.key?(:key)
+          @nested_restriction = args[:nested_restriction] if args.key?(:nested_restriction)
           @restriction_type = args[:restriction_type] if args.key?(:restriction_type)
           @title = args[:title] if args.key?(:title)
         end
@@ -152,6 +268,29 @@ module Google
         end
       end
       
+      # An event generated when a new version of an app is uploaded to Google Play.
+      # Notifications are sent for new public versions only: alpha, beta, or canary
+      # versions do not generate this event. To fetch up-to-date version history for
+      # an app, use Products.Get on the EMM API.
+      class AppUpdateEvent
+        include Google::Apis::Core::Hashable
+      
+        # The id of the product (e.g. "app:com.google.android.gm") that was updated.
+        # This field will always be present.
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @product_id = args[:product_id] if args.key?(:product_id)
+        end
+      end
+      
       # This represents a single version of the app.
       class AppVersion
         include Google::Apis::Core::Hashable
@@ -206,6 +345,35 @@ module Google
         end
       end
       
+      # An AuthenticationToken is used by the EMM's device policy client on a device
+      # to provision the given EMM-managed user on that device.
+      class AuthenticationToken
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#authenticationToken".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The authentication token to be passed to the device policy client on the
+        # device where it can be used to provision the account for which this token was
+        # generated.
+        # Corresponds to the JSON property `token`
+        # @return [String]
+        attr_accessor :token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @token = args[:token] if args.key?(:token)
+        end
+      end
+      
       # A collection resource defines a named set of apps that is visible to a set of
       # users in the Google Play Store app running on those users' managed devices.
       # Those users can then install any of those apps if they wish (which will
@@ -339,12 +507,19 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The mechanism by which this device is managed by the EMM. "managedDevice"
-        # means that the EMM's app is a device owner. "managedProfile" means that the
-        # EMM's app is the profile owner (and there is a separate personal profile which
-        # is not managed). "containerApp" means that the EMM's app is managing the
-        # Android for Work container app on the device. ?unmanagedProfile? means that
-        # the EMM?s app is managing a managed user on an unmanaged device
+        # Identifies the extent to which the device is controlled by an Android for Work
+        # EMM in various deployment configurations.
+        # Possible values include:
+        # - "managedDevice", a device that has the EMM's device policy controller (DPC)
+        # as the device owner,
+        # - "managedProfile", a device that has a work profile managed by the DPC (DPC
+        # is profile owner) in addition to a separate, personal profile that is
+        # unavailable to the DPC,
+        # - "containerApp", a device running the Android for Work App. The Android for
+        # Work App is managed by the DPC,
+        # - "unmanagedProfile", a device that has been allowed (by the domain's admin,
+        # using the Admin Console to enable the privilege) to use Android for Work apps
+        # or Google Apps for Work, but the profile is itself not owned by a DPC.
         # Corresponds to the JSON property `managementType`
         # @return [String]
         attr_accessor :management_type
@@ -417,33 +592,27 @@ module Google
         end
       end
       
-      # An enterprise resource represents a binding between an organization and their
-      # EMM.
-      # To create an enterprise, an admin of the enterprise must first go through a
-      # Play for Work sign-up flow. At the end of this the admin will be presented
-      # with a token (a short opaque alphanumeric string). They must then present this
-      # to the EMM, who then supplies it to the enroll method. Until this is done the
-      # EMM will not have any access to the enterprise.
-      # After calling enroll the EMM should call setAccount to specify the service
-      # account that will be allowed to act on behalf of the enterprise, which will be
-      # required for access to the enterprise's data through this API. Only one call
-      # of setAccount is allowed for a given enterprise; the only way to change the
-      # account later is to unenroll the enterprise and enroll it again (obtaining a
-      # new token).
-      # The EMM can unenroll an enterprise in order to sever the binding between them.
-      # Re-enrolling an enterprise is possible, but requires a new token to be
-      # retrieved. Enterprises.unenroll requires the EMM's credentials (as enroll does)
-      # , not the enterprise's. Enterprises.unenroll can only be used for enterprises
-      # that were previously enrolled with the enroll call. Any enterprises that were
-      # enrolled using the (deprecated) Enterprises.insert call must be unenrolled
-      # with Enterprises.delete and can then be re-enrolled using the Enterprises.
-      # enroll call.
-      # The ID for an enterprise is an opaque string. It is returned by insert and
-      # enroll and can also be retrieved if the enterprise's primary domain is known
-      # using the list method.
+      # An Enterprises resource represents the binding between an EMM and a specific
+      # organization. That binding can be instantiated in one of two different ways
+      # using this API as follows:
+      # - For Google managed domain customers, the process involves using Enterprises.
+      # enroll and Enterprises.setAccount (in conjunction with artifacts obtained from
+      # the Admin console and the Google API Console) and submitted to the EMM through
+      # a more-or-less manual process.
+      # - For Android for Work Accounts customers, the process involves using
+      # Enterprises.generateSignupUrl and Enterprises.completeSignup in conjunction
+      # with the Android for Work Sign-up UI (Google-provided mechanism) to create the
+      # binding without manual steps. As an EMM, you can support either or both
+      # approaches in your EMM console. See Create an Enterprise for details.
       class Enterprise
         include Google::Apis::Core::Hashable
       
+        # Administrators of the enterprise. This is only supported for enterprises
+        # created via the EMM-initiated flow.
+        # Corresponds to the JSON property `administrator`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::Administrator>]
+        attr_accessor :administrator
+      
         # The unique ID for the enterprise.
         # Corresponds to the JSON property `id`
         # @return [String]
@@ -455,12 +624,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The name of the enterprise, e.g. "Example Inc".
+        # The name of the enterprise, for example, "Example, Inc".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The enterprise's primary domain, e.g. "example.com".
+        # The enterprise's primary domain, such as "example.com".
         # Corresponds to the JSON property `primaryDomain`
         # @return [String]
         attr_accessor :primary_domain
@@ -471,6 +640,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @administrator = args[:administrator] if args.key?(:administrator)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
           @name = args[:name] if args.key?(:name)
@@ -831,6 +1001,50 @@ module Google
         end
       end
       
+      # An event generated when an app installation failed on a device
+      class InstallFailureEvent
+        include Google::Apis::Core::Hashable
+      
+        # The Android ID of the device. This field will always be present.
+        # Corresponds to the JSON property `deviceId`
+        # @return [String]
+        attr_accessor :device_id
+      
+        # Additional details on the failure if applicable.
+        # Corresponds to the JSON property `failureDetails`
+        # @return [String]
+        attr_accessor :failure_details
+      
+        # The reason for the installation failure. This field will always be present.
+        # Corresponds to the JSON property `failureReason`
+        # @return [String]
+        attr_accessor :failure_reason
+      
+        # The id of the product (e.g. "app:com.google.android.gm") for which the install
+        # failure event occured. This field will always be present.
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+      
+        # The ID of the user. This field will always be present.
+        # Corresponds to the JSON property `userId`
+        # @return [String]
+        attr_accessor :user_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @device_id = args[:device_id] if args.key?(:device_id)
+          @failure_details = args[:failure_details] if args.key?(:failure_details)
+          @failure_reason = args[:failure_reason] if args.key?(:failure_reason)
+          @product_id = args[:product_id] if args.key?(:product_id)
+          @user_id = args[:user_id] if args.key?(:user_id)
+        end
+      end
+      
       # The install resources for the device.
       class ListInstallsResponse
         include Google::Apis::Core::Hashable
@@ -883,6 +1097,314 @@ module Google
         end
       end
       
+      # A managed configuration resource contains the set of managed properties that
+      # have been configured for an Android app. The app's developer would have
+      # defined configurable properties in the managed configurations schema.
+      class ManagedConfiguration
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#managedConfiguration".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The set of managed properties for this configuration.
+        # Corresponds to the JSON property `managedProperty`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::ManagedProperty>]
+        attr_accessor :managed_property
+      
+        # The ID of the product that the managed configuration is for, e.g. "app:com.
+        # google.android.gm".
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @managed_property = args[:managed_property] if args.key?(:managed_property)
+          @product_id = args[:product_id] if args.key?(:product_id)
+        end
+      end
+      
+      # The managed configuration resources for the device.
+      class ManagedConfigurationsForDeviceListResponse
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#managedConfigurationsForDeviceListResponse".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # A managed configuration for an app on a specific device.
+        # Corresponds to the JSON property `managedConfigurationForDevice`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::ManagedConfiguration>]
+        attr_accessor :managed_configuration_for_device
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @managed_configuration_for_device = args[:managed_configuration_for_device] if args.key?(:managed_configuration_for_device)
+        end
+      end
+      
+      # The managed configuration resources for the user.
+      class ManagedConfigurationsForUserListResponse
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#managedConfigurationsForUserListResponse".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # A managed configuration for an app for a specific user.
+        # Corresponds to the JSON property `managedConfigurationForUser`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::ManagedConfiguration>]
+        attr_accessor :managed_configuration_for_user
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @managed_configuration_for_user = args[:managed_configuration_for_user] if args.key?(:managed_configuration_for_user)
+        end
+      end
+      
+      # A managed property of a managed configuration. The property must match one of
+      # the properties in the app restrictions schema of the product. Exactly one of
+      # the value fields must be populated, and it must match the property's type in
+      # the app restrictions schema.
+      class ManagedProperty
+        include Google::Apis::Core::Hashable
+      
+        # The unique key that identifies the property.
+        # Corresponds to the JSON property `key`
+        # @return [String]
+        attr_accessor :key
+      
+        # The boolean value - this will only be present if type of the property is bool.
+        # Corresponds to the JSON property `valueBool`
+        # @return [Boolean]
+        attr_accessor :value_bool
+        alias_method :value_bool?, :value_bool
+      
+        # A bundle of managed properties.
+        # Corresponds to the JSON property `valueBundle`
+        # @return [Google::Apis::AndroidenterpriseV1::ManagedPropertyBundle]
+        attr_accessor :value_bundle
+      
+        # The list of bundles of properties - this will only be present if type of the
+        # property is bundle_array.
+        # Corresponds to the JSON property `valueBundleArray`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::ManagedPropertyBundle>]
+        attr_accessor :value_bundle_array
+      
+        # The integer value - this will only be present if type of the property is
+        # integer.
+        # Corresponds to the JSON property `valueInteger`
+        # @return [Fixnum]
+        attr_accessor :value_integer
+      
+        # The string value - this will only be present if type of the property is string,
+        # choice or hidden.
+        # Corresponds to the JSON property `valueString`
+        # @return [String]
+        attr_accessor :value_string
+      
+        # The list of string values - this will only be present if type of the property
+        # is multiselect.
+        # Corresponds to the JSON property `valueStringArray`
+        # @return [Array<String>]
+        attr_accessor :value_string_array
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @key = args[:key] if args.key?(:key)
+          @value_bool = args[:value_bool] if args.key?(:value_bool)
+          @value_bundle = args[:value_bundle] if args.key?(:value_bundle)
+          @value_bundle_array = args[:value_bundle_array] if args.key?(:value_bundle_array)
+          @value_integer = args[:value_integer] if args.key?(:value_integer)
+          @value_string = args[:value_string] if args.key?(:value_string)
+          @value_string_array = args[:value_string_array] if args.key?(:value_string_array)
+        end
+      end
+      
+      # A bundle of managed properties.
+      class ManagedPropertyBundle
+        include Google::Apis::Core::Hashable
+      
+        # The list of managed properties.
+        # Corresponds to the JSON property `managedProperty`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::ManagedProperty>]
+        attr_accessor :managed_property
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @managed_property = args[:managed_property] if args.key?(:managed_property)
+        end
+      end
+      
+      # An event generated when new permissions are added to an app.
+      class NewPermissionsEvent
+        include Google::Apis::Core::Hashable
+      
+        # The set of permissions that the enterprise admin has already approved for this
+        # application. Use Permissions.Get on the EMM API to retrieve details about
+        # these permissions.
+        # Corresponds to the JSON property `approvedPermissions`
+        # @return [Array<String>]
+        attr_accessor :approved_permissions
+      
+        # The id of the product (e.g. "app:com.google.android.gm") for which new
+        # permissions were added. This field will always be present.
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+      
+        # The set of permissions that the app is currently requesting. Use Permissions.
+        # Get on the EMM API to retrieve details about these permissions.
+        # Corresponds to the JSON property `requestedPermissions`
+        # @return [Array<String>]
+        attr_accessor :requested_permissions
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @approved_permissions = args[:approved_permissions] if args.key?(:approved_permissions)
+          @product_id = args[:product_id] if args.key?(:product_id)
+          @requested_permissions = args[:requested_permissions] if args.key?(:requested_permissions)
+        end
+      end
+      
+      # A notification of one event relating to an enterprise.
+      class Notification
+        include Google::Apis::Core::Hashable
+      
+        # An event generated when a new app version is uploaded to Google Play and its
+        # app restrictions schema changed. To fetch the app restrictions schema for an
+        # app, use Products.getAppRestrictionsSchema on the EMM API.
+        # Corresponds to the JSON property `appRestrictionsSchemaChangeEvent`
+        # @return [Google::Apis::AndroidenterpriseV1::AppRestrictionsSchemaChangeEvent]
+        attr_accessor :app_restrictions_schema_change_event
+      
+        # An event generated when a new version of an app is uploaded to Google Play.
+        # Notifications are sent for new public versions only: alpha, beta, or canary
+        # versions do not generate this event. To fetch up-to-date version history for
+        # an app, use Products.Get on the EMM API.
+        # Corresponds to the JSON property `appUpdateEvent`
+        # @return [Google::Apis::AndroidenterpriseV1::AppUpdateEvent]
+        attr_accessor :app_update_event
+      
+        # The ID of the enterprise for which the notification is sent. This will always
+        # be present.
+        # Corresponds to the JSON property `enterpriseId`
+        # @return [String]
+        attr_accessor :enterprise_id
+      
+        # An event generated when an app installation failed on a device
+        # Corresponds to the JSON property `installFailureEvent`
+        # @return [Google::Apis::AndroidenterpriseV1::InstallFailureEvent]
+        attr_accessor :install_failure_event
+      
+        # An event generated when new permissions are added to an app.
+        # Corresponds to the JSON property `newPermissionsEvent`
+        # @return [Google::Apis::AndroidenterpriseV1::NewPermissionsEvent]
+        attr_accessor :new_permissions_event
+      
+        # An event generated when a product's approval status is changed.
+        # Corresponds to the JSON property `productApprovalEvent`
+        # @return [Google::Apis::AndroidenterpriseV1::ProductApprovalEvent]
+        attr_accessor :product_approval_event
+      
+        # An event generated whenever a product's availability changes.
+        # Corresponds to the JSON property `productAvailabilityChangeEvent`
+        # @return [Google::Apis::AndroidenterpriseV1::ProductAvailabilityChangeEvent]
+        attr_accessor :product_availability_change_event
+      
+        # The time when the notification was published in milliseconds since 1970-01-
+        # 01T00:00:00Z. This will always be present.
+        # Corresponds to the JSON property `timestampMillis`
+        # @return [String]
+        attr_accessor :timestamp_millis
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @app_restrictions_schema_change_event = args[:app_restrictions_schema_change_event] if args.key?(:app_restrictions_schema_change_event)
+          @app_update_event = args[:app_update_event] if args.key?(:app_update_event)
+          @enterprise_id = args[:enterprise_id] if args.key?(:enterprise_id)
+          @install_failure_event = args[:install_failure_event] if args.key?(:install_failure_event)
+          @new_permissions_event = args[:new_permissions_event] if args.key?(:new_permissions_event)
+          @product_approval_event = args[:product_approval_event] if args.key?(:product_approval_event)
+          @product_availability_change_event = args[:product_availability_change_event] if args.key?(:product_availability_change_event)
+          @timestamp_millis = args[:timestamp_millis] if args.key?(:timestamp_millis)
+        end
+      end
+      
+      # A resource returned by the PullNotificationSet API, which contains a
+      # collection of notifications for enterprises associated with the service
+      # account authenticated for the request.
+      class NotificationSet
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#notificationSet".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The notifications received, or empty if no notifications are present.
+        # Corresponds to the JSON property `notification`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::Notification>]
+        attr_accessor :notification
+      
+        # The notification set ID, required to mark the notification as received with
+        # the Enterprises.AcknowledgeNotification API. This will be omitted if no
+        # notifications are present.
+        # Corresponds to the JSON property `notificationSetId`
+        # @return [String]
+        attr_accessor :notification_set_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @notification = args[:notification] if args.key?(:notification)
+          @notification_set_id = args[:notification_set_id] if args.key?(:notification_set_id)
+        end
+      end
+      
       # 
       class PageInfo
         include Google::Apis::Core::Hashable
@@ -958,10 +1480,10 @@ module Google
         end
       end
       
-      # A product represents an app in the Google Play Store that is available to at
-      # least some users in the enterprise. (Some apps are restricted to a single
-      # enterprise, and no information about them is made available outside that
-      # enterprise.)
+      # A Products resource represents an app in the Google Play Store that is
+      # available to at least some users in the enterprise. (Some apps are restricted
+      # to a single enterprise, and no information about them is made available
+      # outside that enterprise.)
       # The information provided for each product (localized name, icon, link to the
       # full Google Play details page) is intended to allow a basic representation of
       # the product within an EMM user interface.
@@ -1012,7 +1534,9 @@ module Google
         # @return [String]
         attr_accessor :product_id
       
-        # Whether this product is free, free with in-app purchases, or paid.
+        # Whether this product is free, free with in-app purchases, or paid. If the
+        # pricing is unknown, this means the product is not generally available anymore (
+        # even though it might still be available to people who own it).
         # Corresponds to the JSON property `productPricing`
         # @return [String]
         attr_accessor :product_pricing
@@ -1062,6 +1586,59 @@ module Google
         end
       end
       
+      # An event generated when a product's approval status is changed.
+      class ProductApprovalEvent
+        include Google::Apis::Core::Hashable
+      
+        # Whether the product was approved or unapproved. This field will always be
+        # present.
+        # Corresponds to the JSON property `approved`
+        # @return [String]
+        attr_accessor :approved
+      
+        # The id of the product (e.g. "app:com.google.android.gm") for which the
+        # approval status has changed. This field will always be present.
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @approved = args[:approved] if args.key?(:approved)
+          @product_id = args[:product_id] if args.key?(:product_id)
+        end
+      end
+      
+      # An event generated whenever a product's availability changes.
+      class ProductAvailabilityChangeEvent
+        include Google::Apis::Core::Hashable
+      
+        # The new state of the product. This field will always be present.
+        # Corresponds to the JSON property `availabilityStatus`
+        # @return [String]
+        attr_accessor :availability_status
+      
+        # The id of the product (e.g. "app:com.google.android.gm") for which the product
+        # availability changed. This field will always be present.
+        # Corresponds to the JSON property `productId`
+        # @return [String]
+        attr_accessor :product_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @availability_status = args[:availability_status] if args.key?(:availability_status)
+          @product_id = args[:product_id] if args.key?(:product_id)
+        end
+      end
+      
       # A product permissions resource represents the set of permissions required by a
       # specific app and whether or not they have been accepted by an enterprise admin.
       # The API can be used to read the set of permissions, and also to update the set
@@ -1139,6 +1716,15 @@ module Google
         # @return [Array<String>]
         attr_accessor :product_id
       
+        # The interpretation of this product set. "unknown" should never be sent and
+        # ignored if received. "whitelist" means that this product set constitutes a
+        # whitelist. "includeAll" means that all products are accessible (the value of
+        # the productId field is therefore ignored). If a value is not supplied, it is
+        # interpreted to be "whitelist" for backwards compatibility.
+        # Corresponds to the JSON property `productSetBehavior`
+        # @return [String]
+        attr_accessor :product_set_behavior
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1147,6 +1733,7 @@ module Google
         def update!(**args)
           @kind = args[:kind] if args.key?(:kind)
           @product_id = args[:product_id] if args.key?(:product_id)
+          @product_set_behavior = args[:product_set_behavior] if args.key?(:product_set_behavior)
         end
       end
       
@@ -1234,6 +1821,134 @@ module Google
         end
       end
       
+      # A service account identity, including the name and credentials that can be
+      # used to authenticate as the service account.
+      class ServiceAccount
+        include Google::Apis::Core::Hashable
+      
+        # Credentials that can be used to authenticate as a service account.
+        # Corresponds to the JSON property `key`
+        # @return [Google::Apis::AndroidenterpriseV1::ServiceAccountKey]
+        attr_accessor :key
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#serviceAccount".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The account name of the service account, in the form of an email address.
+        # Assigned by the server.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @key = args[:key] if args.key?(:key)
+          @kind = args[:kind] if args.key?(:kind)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # Credentials that can be used to authenticate as a service account.
+      class ServiceAccountKey
+        include Google::Apis::Core::Hashable
+      
+        # The body of the private key credentials file, in string format. This is only
+        # populated when the ServiceAccountKey is created, and is not stored by Google.
+        # Corresponds to the JSON property `data`
+        # @return [String]
+        attr_accessor :data
+      
+        # An opaque, unique identifier for this ServiceAccountKey. Assigned by the
+        # server.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#serviceAccountKey".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The file format of the generated key data.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @id = args[:id] if args.key?(:id)
+          @kind = args[:kind] if args.key?(:kind)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # 
+      class ServiceAccountKeysListResponse
+        include Google::Apis::Core::Hashable
+      
+        # The service account credentials.
+        # Corresponds to the JSON property `serviceAccountKey`
+        # @return [Array<Google::Apis::AndroidenterpriseV1::ServiceAccountKey>]
+        attr_accessor :service_account_key
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @service_account_key = args[:service_account_key] if args.key?(:service_account_key)
+        end
+      end
+      
+      # A resource returned by the GenerateSignupUrl API, which contains the Signup
+      # URL and Completion Token.
+      class SignupInfo
+        include Google::Apis::Core::Hashable
+      
+        # An opaque token that will be required, along with the Enterprise Token, for
+        # obtaining the enterprise resource from CompleteSignup.
+        # Corresponds to the JSON property `completionToken`
+        # @return [String]
+        attr_accessor :completion_token
+      
+        # Identifies what kind of resource this is. Value: the fixed string "
+        # androidenterprise#signupInfo".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # A URL under which the Admin can sign up for an enterprise. The page pointed to
+        # cannot be rendered in an iframe.
+        # Corresponds to the JSON property `url`
+        # @return [String]
+        attr_accessor :url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @completion_token = args[:completion_token] if args.key?(:completion_token)
+          @kind = args[:kind] if args.key?(:kind)
+          @url = args[:url] if args.key?(:url)
+        end
+      end
+      
       # Definition of a Google Play for Work store cluster, a list of products
       # displayed as part of a store page.
       class StoreCluster
@@ -1294,8 +2009,8 @@ module Google
       
         # The ID of the store page to be used as the homepage. The homepage will be used
         # as the first page shown in the Google Play for Work store.
-        # If there is no homepage set, an empty store is shown. The homepage can be
-        # unset (by not specifying it) to empty the store.
+        # If a homepage has not been set, the Play store shown on devices will be empty.
+        # Not specifying a homepage on a store layout effectively empties the store.
         # If there exists at least one page, this field must be set to the ID of a valid
         # page.
         # Corresponds to the JSON property `homepageId`
@@ -1308,6 +2023,17 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # The store layout type. By default, this value is set to "basic". If set to "
+        # custom", "homepageId" must be specified. If set to "basic", the layout will
+        # consist of all approved apps accessible by the user, split in pages of 100
+        # each; in this case, "homepageId" must not be specified. The "basic" setting
+        # takes precedence over any existing collections setup for this enterprise (if
+        # any). Should the enterprise use collectionViewers for controlling access
+        # rights, these will still be respected.
+        # Corresponds to the JSON property `storeLayoutType`
+        # @return [String]
+        attr_accessor :store_layout_type
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1316,6 +2042,7 @@ module Google
         def update!(**args)
           @homepage_id = args[:homepage_id] if args.key?(:homepage_id)
           @kind = args[:kind] if args.key?(:kind)
+          @store_layout_type = args[:store_layout_type] if args.key?(:store_layout_type)
         end
       end
       
@@ -1441,17 +2168,42 @@ module Google
         end
       end
       
-      # A user resource represents an individual user within the enterprise's domain.
-      # Note that each user is associated with a Google account based on the user's
-      # corporate email address (which must be in one of the enterprise's domains). As
-      # part of installing the EMM's DPC app to manage a device the Google account
-      # must be provisioned to the device, and so the user resource must be created
-      # before that. This can be done using the Google Admin SDK Directory API.
-      # The ID for a user is an opaque string. It can be retrieved using the list
-      # method queried by the user's primary email address.
+      # A Users resource represents an account associated with an enterprise. The
+      # account may be specific to a device or to an individual user (who can then use
+      # the account across multiple devices). The account may provide access to Google
+      # Play for Work only, or to other Google services, depending on the identity
+      # model:
+      # - Google managed domain identity model requires synchronization to Google
+      # account sources (via primaryEmail).
+      # - Android for Work Accounts identity model provides a dynamic means for
+      # enterprises to create user or device accounts as needed. These accounts
+      # provide access to Google Play for Work only.
       class User
         include Google::Apis::Core::Hashable
       
+        # A unique identifier you create for this user, such as "user342" or "asset#
+        # 44418". Do not use personally identifiable information (PII) for this property.
+        # Must always be set for EMM-managed users. Not set for Google-managed users.
+        # Corresponds to the JSON property `accountIdentifier`
+        # @return [String]
+        attr_accessor :account_identifier
+      
+        # The type of account that this user represents. A userAccount can be installed
+        # on multiple devices, but a deviceAccount is specific to a single device. An
+        # EMM-managed user (emmManaged) can be either type (userAccount, deviceAccount),
+        # but a Google-managed user (googleManaged) is always a userAccount.
+        # Corresponds to the JSON property `accountType`
+        # @return [String]
+        attr_accessor :account_type
+      
+        # The name that will appear in user interfaces. Setting this property is
+        # optional when creating EMM-managed users. If you do set this property, use
+        # something generic about the organization (such as "Example, Inc.") or your
+        # name (as EMM). Not used for Google-managed user accounts.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
         # The unique ID for the user.
         # Corresponds to the JSON property `id`
         # @return [String]
@@ -1463,7 +2215,15 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The user's primary email, e.g. "jsmith@example.com".
+        # The entity that manages the user. With googleManaged users, the source of
+        # truth is Google so EMMs have to make sure a Google Account exists for the user.
+        # With emmManaged users, the EMM is in charge.
+        # Corresponds to the JSON property `managementType`
+        # @return [String]
+        attr_accessor :management_type
+      
+        # The user's primary email address, for example, "jsmith@example.com". Will
+        # always be set for Google managed users and not set for EMM managed users.
         # Corresponds to the JSON property `primaryEmail`
         # @return [String]
         attr_accessor :primary_email
@@ -1474,8 +2234,12 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @account_identifier = args[:account_identifier] if args.key?(:account_identifier)
+          @account_type = args[:account_type] if args.key?(:account_type)
+          @display_name = args[:display_name] if args.key?(:display_name)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
+          @management_type = args[:management_type] if args.key?(:management_type)
           @primary_email = args[:primary_email] if args.key?(:primary_email)
         end
       end