Api-roll 33: 2016-03-14

generated/googleapis/lib/androidenterprise/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.androidenterprise.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 793 matching lines @@
 }
 
 
 class EnterprisesResourceApi {
   final commons.ApiRequester _requester;
 
   EnterprisesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes the binding between the MDM and enterprise. This is now deprecated;
+   * Deletes the binding between the EMM and enterprise. This is now deprecated;
    * use this to unenroll customers that were previously enrolled with the
    * 'insert' call, then enroll them again with the 'enroll' call.
    *
    * Request parameters:
    *
    * [enterpriseId] - The ID of the enterprise.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 20 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
-   * Enrolls an enterprise with the calling MDM.
+   * Enrolls an enterprise with the calling EMM.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [token] - The token provided by the enterprise to register the MDM.
+   * [token] - The token provided by the enterprise to register the EMM.
    *
    * Completes with a [Enterprise].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Enterprise> enroll(Enterprise request, core.String token) {
@@ skipping 96 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new StoreLayout.fromJson(data));
   }
 
   /**
-   * Establishes the binding between the MDM and an enterprise. This is now
+   * Establishes the binding between the EMM and an enterprise. This is now
    * deprecated; use enroll instead.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [token] - The token provided by the enterprise to register the MDM.
+   * [token] - The token provided by the enterprise to register the EMM.
    *
    * Completes with a [Enterprise].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Enterprise> insert(Enterprise request, core.String token) {
@@ skipping 58 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new EnterprisesListResponse.fromJson(data));
   }
 
   /**
-   * Sends a test push notification to validate the MDM integration with the
+   * Sends a test push notification to validate the EMM integration with the
    * Google Cloud Pub/Sub service for this enterprise.
    *
    * Request parameters:
    *
    * [enterpriseId] - The ID of the enterprise.
    *
    * Completes with a [EnterprisesSendTestPushNotificationResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 108 matching lines @@
                                        "PUT",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new StoreLayout.fromJson(data));
   }
 
   /**
-   * Unenrolls an enterprise from the calling MDM.
+   * Unenrolls an enterprise from the calling EMM.
    *
    * Request parameters:
    *
    * [enterpriseId] - The ID of the enterprise.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 1056 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ProductPermissions.fromJson(data));
   }
 
   /**
-   * Updates the set of Android app permissions for this app that have been
-   * accepted by the enterprise.
+   * This method has been deprecated. To programmatically approve applications,
+   * you must use the iframe mechanism via the  generateApprovalUrl and  approve
+   * methods of the Products resource. For more information, see the  Play EMM
+   * API usage requirements.
+   *
+   * The updatePermissions method (deprecated) updates the set of Android app
+   * permissions for this app that have been accepted by the enterprise.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [enterpriseId] - The ID of the enterprise.
    *
    * [productId] - The ID of the product.
    *
    * Completes with a [ProductPermissions].
@@ skipping 627 matching lines @@
   final commons.ApiRequester _requester;
 
   UsersResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Generates a token (activation code) to allow this user to configure their
    * work account in the Android Setup Wizard. Revokes any previously generated
    * token.
    *
+   * This call only works with Google managed accounts.
+   *
    * Request parameters:
    *
    * [enterpriseId] - The ID of the enterprise.
    *
    * [userId] - The ID of the user.
    *
    * Completes with a [UserToken].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 110 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ProductSet.fromJson(data));
   }
 
   /**
-   * Looks up a user by email address. This only works for Google managed users.
+   * Looks up a user by their primary email address.
    *
    * Request parameters:
    *
    * [enterpriseId] - The ID of the enterprise.
    *
    * [email] - The exact primary email address of the user to look up.
    *
    * Completes with a [UsersListResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ skipping 525 matching lines @@
       _json["collection"] = collection.map((value) => (value).toJson()).toList();
     }
     if (kind != null) {
       _json["kind"] = kind;
     }
     return _json;
   }
 }
 
 /**
- * A device resource represents a mobile device managed by the MDM and belonging
+ * A device resource represents a mobile device managed by the EMM and belonging
  * to a specific enterprise user.
  *
  * This collection cannot be modified via the API; it is automatically populated
  * as devices are set up to be managed.
  */
 class Device {
   /**
    * The Google Play Services Android ID for the device encoded as a lowercase
    * hex string, e.g. "123456789abcdef0".
    */
   core.String androidId;
   /**
    * Identifies what kind of resource this is. Value: the fixed string
    * "androidenterprise#device".
    */
   core.String kind;
   /**
-   * The mechanism by which this device is managed by the MDM. "managedDevice"
-   * means that the MDM's app is a device owner. "managedProfile" means that the
-   * MDM's app is the profile owner (and there is a separate personal profile
-   * which is not managed). "containerApp" means that the MDM's app is managing
+   * 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.
    */
   core.String managementType;
 
   Device();
 
   Device.fromJson(core.Map _json) {
     if (_json.containsKey("androidId")) {
       androidId = _json["androidId"];
     }
@@ skipping 89 matching lines @@
     }
     if (kind != null) {
       _json["kind"] = kind;
     }
     return _json;
   }
 }
 
 /**
  * An enterprise resource represents a binding between an organisation and their
- * MDM.
+ * 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 MDM, who then supplies it to the enroll method. Until this is
- * done the MDM will not have any access to the enterprise.
+ * 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 MDM should call setAccount to specify the service
+ * 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 MDM can unenroll an enterprise in order to sever the binding between
+ * 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 MDM's credentials (as enroll
+ * 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.
  */
@@ skipping 148 matching lines @@
 
 /**
  * The existence of an entitlement resource means that a user has the right to
  * use a particular app on any of their devices. This might be because the app
  * is free or because they have been allocated a license to the app from a group
  * license purchased by the enterprise.
  *
  * It should always be true that a user has an app installed on one of their
  * devices only if they have an entitlement to it. So if an entitlement is
  * deleted, the app will be uninstalled from all devices. Similarly if the user
- * installs an app (and is permitted to do so), or the MDM triggers an install
+ * installs an app (and is permitted to do so), or the EMM triggers an install
  * of the app, an entitlement to that app is automatically created. If this is
  * impossible - e.g. the enterprise has not purchased sufficient licenses - then
  * installation fails.
  *
  * Note that entitlements are always user specific, not device specific; a user
  * may have an entitlement even though they have not installed the app anywhere.
  * Once they have an entitlement they can install the app on multiple devices.
  *
  * The API can be used to create an entitlement. If the app is a free app, a
  * group license for that app is created. If it's a paid app, creating the
@@ skipping 414 matching lines @@
   }
 }
 
 /**
  * A permission represents some extra capability, to be granted to an Android
  * app, which requires explicit consent. An enterprise admin must consent to
  * these permissions on behalf of their users before an entitlement for the app
  * can be created.
  *
  * The permissions collection is read-only. The information provided for each
- * permission (localized name and description) is intended to be used in the MDM
+ * permission (localized name and description) is intended to be used in the EMM
  * user interface when obtaining consent from the enterprise.
  */
 class Permission {
   /**
    * A longer description of the permissions giving more details of what it
    * affects.
    */
   core.String description;
   /**
    * Identifies what kind of resource this is. Value: the fixed string
@@ skipping 41 matching lines @@
 }
 
 /**
  * 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.)
  *
  * 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 MDM user interface.
+ * the product within an EMM user interface.
  */
 class Product {
   /**
    * App versions currently available for this product. The returned list
    * contains only public versions. Alpha and beta versions are not included.
    */
   core.List<AppVersion> appVersion;
   /** The name of the author of the product (e.g. the app developer). */
   core.String authorName;
   /** A link to the (consumer) Google Play details page for the product. */
@@ skipping 539 matching lines @@
     }
     return _json;
   }
 }
 
 /**
  * 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 an MDM 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.
+ * 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.
  */
 class User {
   /** The unique ID for the user. */
   core.String id;
   /**
    * Identifies what kind of resource this is. Value: the fixed string
    * "androidenterprise#user".
@@ skipping 30 matching lines @@
     if (primaryEmail != null) {
       _json["primaryEmail"] = primaryEmail;
     }
     return _json;
   }
 }
 
 /**
  * A UserToken is used by a user when setting up a managed device or profile
  * with their work account on a device. When the user enters their email address
- * and token (activation code) the appropriate MDM app can be automatically
+ * and token (activation code) the appropriate EMM app can be automatically
  * downloaded.
  */
 class UserToken {
   /**
    * Identifies what kind of resource this is. Value: the fixed string
    * "androidenterprise#userToken".
    */
   core.String kind;
   /**
    * The token (activation code) to be entered by the user. This consists of a
@@ skipping 57 matching lines @@
     var _json = new core.Map();
     if (kind != null) {
       _json["kind"] = kind;
     }
     if (user != null) {
       _json["user"] = user.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }