创建 androidManagedStoreAppCreate androidManagedStoreApp
2021/3/24
本文内容
命名空间:microsoft.graphNamespace: microsoft.graph
重要提示: /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.
注意: 适用于 Intune 的 Microsoft Graph API 需要适用于租户的 活动 Intune 许可证。Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
先决条件Prerequisites
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
权限类型Permission type
权限(从最低特权到最高特权)Permissions (from least to most privileged)
委派(工作或学校帐户)Delegated (work or school account)
DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All
委派(个人 Microsoft 帐户)Delegated (personal Microsoft account)
不支持。Not supported.
应用程序Application
DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All
HTTP 请求HTTP Request
POST /deviceAppManagement/mobileApps
请求标头Request headers
标头Header
值Value
AuthorizationAuthorization
Bearer 。必需。Bearer Required.
接受Accept
application/jsonapplication/json
请求正文Request body
在请求正文中,提供 androidManagedStoreApp 对象的 JSON 表示形式。In the request body, supply a JSON representation for the androidManagedStoreApp object.
下表显示创建 androidManagedStoreApp 时所需的属性。The following table shows the properties that are required when you create the androidManagedStoreApp.
属性Property
类型Type
说明Description
idid
StringString
实体的键。Key of the entity. Inherited from mobileApp
displayNamedisplayName
StringString
管理员提供或导入的应用标题。The admin provided or imported title of the app. Inherited from mobileApp
说明description
StringString
应用的说明。The description of the app. Inherited from mobileApp
publisherpublisher
StringString
应用的发布者。The publisher of the app. Inherited from mobileApp
largeIconlargeIcon
要显示在应用详细信息中并用于图标上传的大图标。The large icon, to be displayed in the app details and used for upload of the icon. Inherited from mobileApp
createdDateTimecreatedDateTime
DateTimeOffsetDateTimeOffset
创建应用的日期和时间。The date and time the app was created. Inherited from mobileApp
lastModifiedDateTimelastModifiedDateTime
DateTimeOffsetDateTimeOffset
上次修改应用的日期和时间。The date and time the app was last modified. Inherited from mobileApp
isFeaturedisFeatured
BooleanBoolean
指示应用是否被管理员标记为特色的值。继承自 mobileAppThe value indicating whether the app is marked as featured by the admin. Inherited from mobileApp
privacyInformationUrlprivacyInformationUrl
StringString
隐私声明 URL。The privacy statement Url. Inherited from mobileApp
informationUrlinformationUrl
StringString
详细信息 URL。The more information Url. Inherited from mobileApp
ownerowner
StringString
应用的所有者。The owner of the app. Inherited from mobileApp
developerdeveloper
StringString
应用的开发者。The developer of the app. Inherited from mobileApp
notesnotes
StringString
应用的备注。Notes for the app. Inherited from mobileApp
uploadStateuploadState
Int32Int32
上载状态。The upload state. 可能的值是:0 - Not Ready 、1 - Ready 、2 - Processing 。Possible values are: 0 - Not Ready, 1 - Ready, 2 - Processing. Inherited from mobileApp
publishingStatepublishingState
应用的发布状态。The publishing state for the app. 除非应用已发布,否则无法分配应用。The app cannot be assigned unless the app is published. Inherited from mobileApp. 可取值为:notPublished、processing、published。Possible values are: notPublished, processing, published.
isAssignedisAssigned
BooleanBoolean
指示是否将应用分配给至少一个组的值。The value indicating whether the app is assigned to at least one group. Inherited from mobileApp
roleScopeTagIdsroleScopeTagIds
String collectionString collection
此移动应用的范围标记 ID 列表。List of scope tag ids for this mobile app. Inherited from mobileApp
dependentAppCountdependentAppCount
Int32Int32
子应用具有的依赖项总数。The total number of dependencies the child app has. Inherited from mobileApp
supersedingAppCountsupersedingAppCount
Int32Int32
此应用直接或间接取代的应用总数。The total number of apps this app directly or indirectly supersedes. Inherited from mobileApp
supersededAppCountsupersededAppCount
Int32Int32
此应用直接或间接被取代的应用总数。The total number of apps this app is directly or indirectly superseded by. Inherited from mobileApp
packageIdpackageId
StringString
包标识符。The package identifier.
appIdentifierappIdentifier
StringString
标识名称。The Identity Name.
usedLicenseCountusedLicenseCount
Int32Int32
使用中的 VPP 许可证数量。The number of VPP licenses in use.
totalLicenseCounttotalLicenseCount
Int32Int32
VPP 许可证的总数。The total number of VPP licenses.
appStoreUrlappStoreUrl
StringString
"播放工作商店"应用 URL。The Play for Work Store app URL.
isPrivateisPrivate
BooleanBoolean
指示应用是否仅适用于给定企业的用户。Indicates whether the app is only available to a given enterprise's users.
isSystemAppisSystemApp
BooleanBoolean
指示应用是否是预安装的系统应用。Indicates whether the app is a preinstalled system app.
appTracksappTracks
此企业可见的轨。The tracks that are visible to this enterprise.
supportsOemConfigsupportsOemConfig
BooleanBoolean
此应用是否支持 OEMConfig 策略。Whether this app supports OEMConfig policy.
响应Response
如果成功,此方法在响应 201 Created 正文中返回 响应代码和 androidManagedStoreApp 对象。If successful, this method returns a 201 Created response code and a androidManagedStoreApp object in the response body.
示例Example
请求Request
下面是一个请求示例。Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1225
{
"@odata.type": "#microsoft.graph.androidManagedStoreApp",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"packageId": "Package Id value",
"appIdentifier": "App Identifier value",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"appStoreUrl": "https://example.com/appStoreUrl/",
"isPrivate": true,
"isSystemApp": true,
"appTracks": [
{
"@odata.type": "microsoft.graph.androidManagedStoreAppTrack",
"trackId": "Track Id value",
"trackAlias": "Track Alias value"
}
],
"supportsOemConfig": true
}
响应Response
下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1397
{
"@odata.type": "#microsoft.graph.androidManagedStoreApp",
"id": "87247525-7525-8724-2575-248725752487",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"packageId": "Package Id value",
"appIdentifier": "App Identifier value",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"appStoreUrl": "https://example.com/appStoreUrl/",
"isPrivate": true,
"isSystemApp": true,
"appTracks": [
{
"@odata.type": "microsoft.graph.androidManagedStoreAppTrack",
"trackId": "Track Id value",
"trackAlias": "Track Alias value"
}
],
"supportsOemConfig": true
}