Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(75)

Issues Search
    My Issues | Starred     Open | Closed | All

Unified Diff: discovery/googleapis/androidenterprise__v1.json

Issue 2734843002: Api-roll 46: 2017-03-06 (Closed)
Patch Set: Created 3 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « discovery/googleapis/analyticsreporting__v4.json ('k') | discovery/googleapis/androidpublisher__v2.json » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: discovery/googleapis/androidenterprise__v1.json
diff --git a/discovery/googleapis/androidenterprise__v1.json b/discovery/googleapis/androidenterprise__v1.json
index 57655b2651750bbbab7c039755e1563f7c958a65..0d7d106424f6a63b3dc70aa3678f105ce0e6c986 100644
--- a/discovery/googleapis/androidenterprise__v1.json
+++ b/discovery/googleapis/androidenterprise__v1.json
@@ -15,7 +15,7 @@
"description": "Manages the deployment of apps to Android for Work users.",
"discoveryVersion": "v1",
"documentationLink": "https://developers.google.com/android/work/play/emm-api",
- "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/qmu3g-0qIQB7C8meI8fD39oNLuA\"",
+ "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/GhRZzPzHWmqlGHjVwgcMslePzRw\"",
"icons": {
"x16": "https://www.google.com/images/icons/product/android-16.png",
"x32": "https://www.google.com/images/icons/product/android-32.png"
@@ -289,7 +289,7 @@
]
},
"delete": {
- "description": "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.",
+ "description": "Deletes the binding between the EMM and enterprise. This is now deprecated. Use this method only to unenroll customers that were previously enrolled with the insert call, then enroll them again with the enroll call.",
"httpMethod": "DELETE",
"id": "androidenterprise.enterprises.delete",
"parameterOrder": [
@@ -485,7 +485,7 @@
]
},
"pullNotificationSet": {
- "description": "Pulls and returns a notification set for the enterprises associated with the service account authenticated for the request. The notification set may be empty if no notification are pending.\nA notification set returned needs to be acknowledged within 20 seconds by calling Enterprises​.AcknowledgeNotificationSet, unless the notification set is empty.\nNotifications that are not acknowledged within the 20 seconds will eventually be included again in the response to another PullNotificationSet request, and those that are never acknowledged will ultimately be deleted according to the Google Cloud Platform Pub/Sub system policy.\nMultiple requests might be performed concurrently to retrieve notifications, in which case the pending notifications (if any) will be split among each caller, if any are pending.\nIf no notifications are present, an empty notification list is returned. Subsequent requests may return more notifications once they become available.",
+ "description": "Pulls and returns a notification set for the enterprises associated with the service account authenticated for the request. The notification set may be empty if no notification are pending.\nA notification set returned needs to be acknowledged within 20 seconds by calling Enterprises.AcknowledgeNotificationSet, unless the notification set is empty.\nNotifications that are not acknowledged within the 20 seconds will eventually be included again in the response to another PullNotificationSet request, and those that are never acknowledged will ultimately be deleted according to the Google Cloud Platform Pub/Sub system policy.\nMultiple requests might be performed concurrently to retrieve notifications, in which case the pending notifications (if any) will be split among each caller, if any are pending.\nIf no notifications are present, an empty notification list is returned. Subsequent requests may return more notifications once they become available.",
"httpMethod": "POST",
"id": "androidenterprise.enterprises.pullNotificationSet",
"parameters": {
@@ -535,7 +535,7 @@
]
},
"setAccount": {
- "description": "Set the account that will be used to authenticate to the API as the enterprise.",
+ "description": "Sets the account that will be used to authenticate to the API as the enterprise.",
"httpMethod": "PUT",
"id": "androidenterprise.enterprises.setAccount",
"parameterOrder": [
@@ -611,7 +611,7 @@
"entitlements": {
"methods": {
"delete": {
- "description": "Removes an entitlement to an app for a user and uninstalls it.",
+ "description": "Removes an entitlement to an app for a user.",
"httpMethod": "DELETE",
"id": "androidenterprise.entitlements.delete",
"parameterOrder": [
@@ -682,7 +682,7 @@
]
},
"list": {
- "description": "List of all entitlements for the specified user. Only the ID is set.",
+ "description": "Lists all entitlements for the specified user. Only the ID is set.",
"httpMethod": "GET",
"id": "androidenterprise.entitlements.list",
"parameterOrder": [
@@ -1019,7 +1019,7 @@
]
},
"patch": {
- "description": "Requests to install the latest version of an app to a device. If the app is already installed then it is updated to the latest version if necessary. This method supports patch semantics.",
+ "description": "Requests to install the latest version of an app to a device. If the app is already installed, then it is updated to the latest version if necessary. This method supports patch semantics.",
"httpMethod": "PATCH",
"id": "androidenterprise.installs.patch",
"parameterOrder": [
@@ -1066,7 +1066,7 @@
]
},
"update": {
- "description": "Requests to install the latest version of an app to a device. If the app is already installed then it is updated to the latest version if necessary.",
+ "description": "Requests to install the latest version of an app to a device. If the app is already installed, then it is updated to the latest version if necessary.",
"httpMethod": "PUT",
"id": "androidenterprise.installs.update",
"parameterOrder": [
@@ -1754,7 +1754,7 @@
"type": "string"
},
"token": {
- "description": "A pagination token is contained in a request’s response when there are more products. The token can be used in a subsequent request to obtain more products, and so forth. This parameter cannot be used in the initial request.",
+ "description": "A pagination token is contained in a request''s response when there are more products. The token can be used in a subsequent request to obtain more products, and so forth. This parameter cannot be used in the initial request.",
"location": "query",
"type": "string"
}
@@ -2604,7 +2604,7 @@
}
}
},
- "revision": "20170131",
+ "revision": "20170222",
"rootUrl": "https://www.googleapis.com/",
"schemas": {
"Administrator": {
@@ -2826,11 +2826,11 @@
"type": "object"
},
"Device": {
- "description": "A device resource represents a mobile device managed by the EMM and belonging to a specific enterprise user.\n\nThis collection cannot be modified via the API; it is automatically populated as devices are set up to be managed.",
+ "description": "A Devices resource represents a mobile device managed by the EMM and belonging to a specific enterprise user.\n\nThis collection cannot be modified via the API. It is automatically populated as devices are set up to be managed.",
"id": "Device",
"properties": {
"androidId": {
- "description": "The Google Play Services Android ID for the device encoded as a lowercase hex string, e.g. \"123456789abcdef0\".",
+ "description": "The Google Play Services Android ID for the device encoded as a lowercase hex string. For example, \"123456789abcdef0\".",
"type": "string"
},
"kind": {
@@ -2966,7 +2966,7 @@
"type": "object"
},
"Entitlement": {
- "description": "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.\n\nIt 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 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.\n\nNote 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.\n\nThe 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 entitlement consumes one license; it remains consumed until the entitlement is removed. Optionally an installation of the app on all the user's managed devices can be triggered at the time the entitlement is created. An entitlement cannot be created for an app if the app requires permissions that the enterprise has not yet accepted.\n\nEntitlements for paid apps that are due to purchases by the user on a non-managed profile will have \"userPurchase\" as entitlement reason; those entitlements cannot be removed via the API.",
+ "description": "The presence of an Entitlements resource indicates that a user has the right to use a particular app. Entitlements are user specific, not device specific. This allows a user with an entitlement to an app to install the app on all their devices. It's also possible for a user to hold an entitlement to an app without installing the app on any device.\n\nThe API can be used to create an entitlement. As an option, you can also use the API to trigger the installation of an app on all a user's managed devices at the same time the entitlement is created.\n\nIf the app is free, creating the entitlement also creates a group license for that app. For paid apps, creating the entitlement consumes one license, and that license remains consumed until the entitlement is removed. If the enterprise hasn't purchased enough licenses, then no entitlement is created and the installation fails. An entitlement is also not created for an app if the app requires permissions that the enterprise hasn't accepted.\n\nIf an entitlement is deleted, the app may be uninstalled from a user's device. As a best practice, uninstall the app by calling Installs.delete() before deleting the entitlement.\n\nEntitlements for apps that a user pays for on an unmanaged profile have \"userPurchase\" as the entitlement reason. These entitlements cannot be removed via the API.",
"id": "Entitlement",
"properties": {
"kind": {
@@ -2975,11 +2975,11 @@
"type": "string"
},
"productId": {
- "description": "The ID of the product that the entitlement is for, e.g. \"app:com.google.android.gm\".",
+ "description": "The ID of the product that the entitlement is for. For example, \"app:com.google.android.gm\".",
"type": "string"
},
"reason": {
- "description": "The reason for the entitlement, e.g. \"free\" for free apps. This is temporary, it will be replaced by the acquisition kind field of group licenses.",
+ "description": "The reason for the entitlement. For example, \"free\" for free apps. This property is temporary: it will be replaced by the acquisition kind field of group licenses.",
"type": "string"
}
},
@@ -3009,11 +3009,11 @@
"id": "GroupLicense",
"properties": {
"acquisitionKind": {
- "description": "How this group license was acquired. \"bulkPurchase\" means that this group license object was created because the enterprise purchased licenses for this product; this is \"free\" otherwise (for free products).",
+ "description": "How this group license was acquired. \"bulkPurchase\" means that this Grouplicenses resource was created because the enterprise purchased licenses for this product; otherwise, the value is \"free\" (for free products).",
"type": "string"
},
"approval": {
- "description": "Whether the product to which this group license relates is currently approved by the enterprise, as either \"approved\" or \"unapproved\". Products are approved when a group license is first created, but this approval may be revoked by an enterprise admin via Google Play. Unapproved products will not be visible to end users in collections and new entitlements to them should not normally be created.",
+ "description": "Whether the product to which this group license relates is currently approved by the enterprise. Products are approved when a group license is first created, but this approval may be revoked by an enterprise admin via Google Play. Unapproved products will not be visible to end users in collections, and new entitlements to them should not normally be created.",
"type": "string"
},
"kind": {
@@ -3027,12 +3027,12 @@
"type": "integer"
},
"numPurchased": {
- "description": "The number of purchased licenses (possibly in multiple purchases). If this field is omitted then there is no limit on the number of licenses that can be provisioned (e.g. if the acquisition kind is \"free\").",
+ "description": "The number of purchased licenses (possibly in multiple purchases). If this field is omitted, then there is no limit on the number of licenses that can be provisioned (for example, if the acquisition kind is \"free\").",
"format": "int32",
"type": "integer"
},
"productId": {
- "description": "The ID of the product that the license is for, e.g. \"app:com.google.android.gm\".",
+ "description": "The ID of the product that the license is for. For example, \"app:com.google.android.gm\".",
"type": "string"
}
},
@@ -3077,7 +3077,7 @@
"type": "object"
},
"Install": {
- "description": "The existence of an install resource indicates that an app is installed on a particular device (or that an install is pending).\n\nThe API can be used to create an install resource using the update method. This triggers the actual install of the app on the device. If the user does not already have an entitlement for the app then an attempt is made to create one. If this fails (e.g. because the app is not free and there is no available license) then the creation of the install fails.\n\nThe API can also be used to update an installed app. If the update method is used on an existing install then the app will be updated to the latest available version.\n\nNote that it is not possible to force the installation of a specific version of an app; the version code is read-only.\n\nIf a user installs an app themselves (as permitted by the enterprise), then again an install resource and possibly an entitlement resource are automatically created.\n\nThe API can also be used to delete an install resource, which triggers the removal of the app from the device. Note that deleting an install does not automatically remove the corresponding entitlement, even if there are no remaining installs. The install resource will also be deleted if the user uninstalls the app themselves.",
+ "description": "The existence of an Installs resource indicates that an app is installed on a particular device (or that an install is pending).\n\nThe API can be used to create an install resource using the update method. This triggers the actual install of the app on the device. If the user does not already have an entitlement for the app, then an attempt is made to create one. If this fails (for example, because the app is not free and there is no available license), then the creation of the install fails.\n\nThe API can also be used to update an installed app. If the update method is used on an existing install, then the app will be updated to the latest available version.\n\nNote that it is not possible to force the installation of a specific version of an app: the version code is read-only.\n\nIf a user installs an app themselves (as permitted by the enterprise), then again an install resource and possibly an entitlement resource are automatically created.\n\nThe API can also be used to delete an install resource, which triggers the removal of the app from the device. Note that deleting an install does not automatically remove the corresponding entitlement, even if there are no remaining installs. The install resource will also be deleted if the user uninstalls the app themselves.",
"id": "Install",
"properties": {
"installState": {
@@ -3090,7 +3090,7 @@
"type": "string"
},
"productId": {
- "description": "The ID of the product that the install is for, e.g. \"app:com.google.android.gm\".",
+ "description": "The ID of the product that the install is for. For example, \"app:com.google.android.gm\".",
"type": "string"
},
"versionCode": {
@@ -3288,7 +3288,7 @@
"type": "string"
},
"managementType": {
- "description": "Identifies the extent to which the device is controlled by an Android for Work EMM in various deployment configurations.\n\nPossible values include: \n- \"managedDevice\", a device that has the EMM's device policy controller (DPC) as the device owner, \n- \"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,",
+ "description": "Identifies the extent to which the device is controlled by an Android EMM in various deployment configurations.\n\nPossible values include: \n- \"managedDevice\", a device where the DPC is set as device owner, \n- \"managedProfile\", a device where the DPC is set as profile owner.",
"type": "string"
},
"userId": {
@@ -3409,11 +3409,11 @@
"type": "object"
},
"Permission": {
- "description": "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.\n\nThe permissions collection is read-only. The information provided for each permission (localized name and description) is intended to be used in the EMM user interface when obtaining consent from the enterprise.",
+ "description": "A Permissions resource 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.\n\nThe permissions collection is read-only. The information provided for each permission (localized name and description) is intended to be used in the MDM user interface when obtaining consent from the enterprise.",
"id": "Permission",
"properties": {
"description": {
- "description": "A longer description of the permissions giving more details of what it affects.",
+ "description": "A longer description of the Permissions resource, giving more details of what it affects.",
"type": "string"
},
"kind": {
@@ -3444,7 +3444,7 @@
"type": "array"
},
"authorName": {
- "description": "The name of the author of the product (e.g. the app developer).",
+ "description": "The name of the author of the product (for example, the app developer).",
"type": "string"
},
"detailsUrl": {
« no previous file with comments | « discovery/googleapis/analyticsreporting__v4.json ('k') | discovery/googleapis/androidpublisher__v2.json » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698