Criar androidForWorkAppCreate androidForWorkApp

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Crie um novo objeto androidForWorkApp.Create a new androidForWorkApp object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All

Solicitação HTTPHTTP Request

POST /deviceAppManagement/mobileApps

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, fornece uma representação JSON para o objeto androidForWorkApp.In the request body, supply a JSON representation for the androidForWorkApp object.

A tabela a seguir mostra as propriedades que são necessárias ao criar o androidForWorkApp.The following table shows the properties that are required when you create the androidForWorkApp.

PropriedadeProperty TipoType DescriçãoDescription
idid Cadeia de caracteresString Chave da entidade.Key of the entity. Herdado de mobileAppInherited from mobileApp
displayNamedisplayName Cadeia de caracteresString O título do aplicativo importado ou definido pelo administrador.The admin provided or imported title of the app. Herdado de mobileAppInherited from mobileApp
descriçãodescription Cadeia de caracteresString A descrição do aplicativo.The description of the app. Herdado de mobileAppInherited from mobileApp
publicadorpublisher StringString O publicador do aplicativo.The publisher of the app. Herdado de mobileAppInherited from mobileApp
largeIconlargeIcon mimeContentmimeContent O ícone grande, a ser exibido nos detalhes do aplicativo e usado para o carregamento do ícone.The large icon, to be displayed in the app details and used for upload of the icon. Herdado de mobileAppInherited from mobileApp
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset A data e a hora da criação do aplicativo.The date and time the app was created. Herdado de mobileAppInherited from mobileApp
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset A data e a hora que o aplicativo foi modificado pela última vez.The date and time the app was last modified. Herdado de mobileAppInherited from mobileApp
isFeaturedisFeatured BooleanBoolean O valor que indica se o aplicativo está marcado como em destaque pelo administrador. Herdado de mobileAppThe value indicating whether the app is marked as featured by the admin. Inherited from mobileApp
privacyInformationUrlprivacyInformationUrl StringString A URL da declaração de privacidade.The privacy statement Url. Herdado de mobileAppInherited from mobileApp
informationUrlinformationUrl StringString A URL de informações adicionais.The more information Url. Herdado de mobileAppInherited from mobileApp
ownerowner Cadeia de caracteresString O proprietário do conteúdo.The owner of the app. Herdado de mobileAppInherited from mobileApp
developerdeveloper StringString O desenvolvedor do aplicativo.The developer of the app. Herdado de mobileAppInherited from mobileApp
notesnotes StringString Anotações do aplicativo.Notes for the app. Herdado de mobileAppInherited from mobileApp
uploadStateuploadState Int32Int32 O estado de carregamento.The upload state. Os valores possíveis são: 0 - Not Ready , 1 - Ready , 2 - Processing .Possible values are: 0 - Not Ready, 1 - Ready, 2 - Processing. Herdado de mobileAppInherited from mobileApp
publishingStatepublishingState mobileAppPublishingStatemobileAppPublishingState O estado de publicação do aplicativo.The publishing state for the app. O aplicativo não pode ser assinado, a menos que ele seja publicado.The app cannot be assigned unless the app is published. Herdado de mobileApp.Inherited from mobileApp. Os valores possíveis são: notPublished, processing, published.Possible values are: notPublished, processing, published.
isAssignedisAssigned BooleanBoolean O valor que indica se o aplicativo é atribuído a pelo menos um grupo.The value indicating whether the app is assigned to at least one group. Herdado de mobileAppInherited from mobileApp
roleScopeTagIdsroleScopeTagIds Coleção de cadeias de caracteresString collection Lista de ids de marca de escopo para este aplicativo móvel.List of scope tag ids for this mobile app. Herdado de mobileAppInherited from mobileApp
dependentAppCountdependentAppCount Int32Int32 O número total de dependências que o aplicativo filho tem.The total number of dependencies the child app has. Herdado de mobileAppInherited from mobileApp
supersedingAppCountsupersedingAppCount Int32Int32 O número total de aplicativos que esse aplicativo sobressede direta ou indiretamente.The total number of apps this app directly or indirectly supersedes. Herdado de mobileAppInherited from mobileApp
supersededAppCountsupersededAppCount Int32Int32 O número total de aplicativos pelos quais esse aplicativo é, direta ou indiretamente, é suplido.The total number of apps this app is directly or indirectly superseded by. Herdado de mobileAppInherited from mobileApp
packageIdpackageId StringString O identificador do pacote.The package identifier.
appIdentifierappIdentifier StringString O Nome da Identidade.The Identity Name.
usedLicenseCountusedLicenseCount Int32Int32 O número de aplicativos VPP em uso.The number of VPP licenses in use.
totalLicenseCounttotalLicenseCount Int32Int32 O número total de licenças VPP.The total number of VPP licenses.
appStoreUrlappStoreUrl StringString A URL do aplicativo Play for Work Store.The Play for Work Store app URL.

RespostaResponse

Se tiver êxito, este método retornará um código 201 Created de resposta e um objeto androidForWorkApp no corpo da resposta.If successful, this method returns a 201 Created response code and a androidForWorkApp object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 960

{
  "@odata.type": "#microsoft.graph.androidForWorkApp",
  "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/"
}

RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.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: 1132

{
  "@odata.type": "#microsoft.graph.androidForWorkApp",
  "id": "c5010785-0785-c501-8507-01c5850701c5",
  "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/"
}