Creación de winGetApp

  • Artículo

Espacio de nombres: microsoft.graph

Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Cree un nuevo objeto winGetApp .

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) DeviceManagementApps.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementApps.ReadWrite.All

Solicitud HTTP

POST /deviceAppManagement/mobileApps

Encabezados de solicitud

Encabezado Valor
Authorization Se requiere <token> de portador.
Accept application/json

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto winGetApp.

En la tabla siguiente se muestran las propiedades necesarias al crear winGetApp.

Propiedad Tipo Descripción
id Cadena Clave de la entidad. Heredado de mobileApp.
displayName Cadena Título de la aplicación importado o proporcionado por el administrador. Heredado de mobileApp.
description Cadena Descripción de la aplicación. Heredado de mobileApp.
publicador Cadena Publicador de la aplicación. Heredado de mobileApp.
largeIcon mimeContent Icono grande que se mostrará en los detalles de la aplicación y se usa para cargar el icono. Heredado de mobileApp.
createdDateTime DateTimeOffset Fecha y hora de creación de la aplicación. Heredado de mobileApp.
lastModifiedDateTime DateTimeOffset Fecha y hora de la última modificación de la aplicación. Heredado de mobileApp.
isFeatured Booleano Valor que indica si el administrador ha marcado la aplicación como destacada. Heredado de mobileApp.
privacyInformationUrl Cadena Dirección URL de la declaración de privacidad. Heredado de mobileApp.
informationUrl Cadena Dirección URL para obtener más información. Heredado de mobileApp.
owner Cadena Propietario de la aplicación. Heredado de mobileApp.
developer Cadena Desarrollador de la aplicación. Heredado de mobileApp.
notas Cadena Notas de la aplicación. Heredado de mobileApp.
uploadState Int32 Estado de carga. Los valores posibles son: 0 - Not Ready, 1 - Ready, 2 - Processing. Heredado de mobileApp.
publishingState mobileAppPublishingState Estado de publicación de la aplicación. La aplicación no puede asignarse a menos que se publique. Se hereda de mobileApp. Los valores posibles son: notPublished, processing y published.
isAssigned Boolean Valor que indica si la aplicación está asignada a al menos un grupo. Heredado de mobileApp.
roleScopeTagIds Colección string Lista de identificadores de etiqueta de ámbito para esta aplicación móvil. Heredado de mobileApp.
dependentAppCount Int32 Número total de dependencias que tiene la aplicación secundaria. Heredado de mobileApp.
supersedingAppCount Int32 El número total de aplicaciones que esta aplicación reemplaza directa o indirectamente. Heredado de mobileApp.
supersededAppCount Int32 El número total de aplicaciones por las que esta aplicación se reemplaza directa o indirectamente. Heredado de mobileApp.
manifestHash Cadena Hash de propiedades de metadatos de paquete usadas para validar que la aplicación coincide con los metadatos del repositorio de origen.
packageIdentifier Cadena PackageIdentifier de la API REST del repositorio de origen de WinGet. Esto también se asigna al identificador cuando se usa la aplicación de línea de comandos del cliente WinGet. Necesario en el momento de la creación, no se puede modificar en objetos existentes.
installExperience winGetAppInstallExperience La configuración de la experiencia de instalación asociada a esta aplicación, que se usa para garantizar que se tienen en cuenta las experiencias de instalación deseadas en el dispositivo de destino. Esto incluye el tipo de cuenta (sistema o usuario) que las acciones deben ejecutarse como en los dispositivos de destino. Necesario en el momento de la creación.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto winGetApp en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

{
  "@odata.type": "#microsoft.graph.winGetApp",
  "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,
  "manifestHash": "Manifest Hash value",
  "packageIdentifier": "Package Identifier value",
  "installExperience": {
    "@odata.type": "microsoft.graph.winGetAppInstallExperience",
    "runAsAccount": "user"
  }
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1157

{
  "@odata.type": "#microsoft.graph.winGetApp",
  "id": "22032c2e-2c2e-2203-2e2c-03222e2c0322",
  "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,
  "manifestHash": "Manifest Hash value",
  "packageIdentifier": "Package Identifier value",
  "installExperience": {
    "@odata.type": "microsoft.graph.winGetAppInstallExperience",
    "runAsAccount": "user"
  }
}