@@ -124,11 +124,17 @@ def get_device(enterprise_id, user_id, device_id, fields: nil, quota_user: nil,
124124 execute_or_queue_command ( command , &block )
125125 end
126126
127- # Retrieves whether a device's access to Google services is enabled or disabled.
128- # The device state takes effect only if enforcing EMM policies on Android
129- # devices is enabled in the Google Admin Console. Otherwise, the device state is
130- # ignored and all devices are allowed access to Google services. This is only
131- # supported for Google-managed users.
127+ # Checks if a device can access Google apps and services for a user. Returns
128+ # whether access is "enabled" or "disabled". A "disabled" state prevents the
129+ # user's Managed Google Account on the device from successfully authenticating
130+ # with Google. This blocks access to most Google applications and services,
131+ # including Google Play, as the device cannot prove its entitlement to access
132+ # them. New devices default to "disabled". Important: Enforcement of this state
133+ # depends on the following conditions: * The user must be a managed google
134+ # account. * The enterprise must be a managed google domain. * Third-party
135+ # Android mobile management must be active in the Google Admin Console for the
136+ # user's Organizational Unit. If these conditions aren't met, access may still
137+ # be possible even in a "disabled" state.
132138 # @param [String] enterprise_id
133139 # The ID of the enterprise.
134140 # @param [String] user_id
@@ -197,11 +203,15 @@ def list_devices(enterprise_id, user_id, fields: nil, quota_user: nil, options:
197203 execute_or_queue_command ( command , &block )
198204 end
199205
200- # Sets whether a device's access to Google services is enabled or disabled. The
201- # device state takes effect only if enforcing EMM policies on Android devices is
202- # enabled in the Google Admin Console. Otherwise, the device state is ignored
203- # and all devices are allowed access to Google services. This is only supported
204- # for Google-managed users.
206+ # Sets whether a device's access to Google services (including Google Play) is
207+ # enabled or disabled for the specified user. Setting the state to "enabled"
208+ # allows the Google Account to access Google services, while "disabled" blocks
209+ # access by preventing OAuth token issuance. Preconditions for Enforcement: 1.
210+ # This setting is only effective for Google-managed users. 2. The enterprise
211+ # must be linked to a Google Managed Domain. 3. Enforcement requires third-party
212+ # Android mobile management to be enabled within the Google Admin Console for
213+ # the user's Organizational Unit. If these preconditions are not met, changes to
214+ # this state may be ignored.
205215 # @param [String] enterprise_id
206216 # The ID of the enterprise.
207217 # @param [String] user_id
0 commit comments