Actualizar officeSuiteApp

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.

Actualice las propiedades de un objeto officeSuiteApp .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	✅

Permisos

Se requiere uno de los siguientes permisos 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)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All

Solicitud HTTP

PATCH /deviceAppManagement/mobileApps/{mobileAppId}

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar	application/json

Cuerpo de la solicitud

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

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

Propiedad	Tipo	Descripción
id	Cadena	Clave de la entidad. Esta propiedad es de sólo lectura. 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. Esta propiedad es de sólo lectura. Heredado de mobileApp.
lastModifiedDateTime	DateTimeOffset	Fecha y hora de la última modificación de la aplicación. Esta propiedad es de sólo lectura. 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. Esta propiedad es de sólo lectura. Heredado de mobileApp.
publishingState	mobileAppPublishingState	Estado de publicación de la aplicación. La aplicación no puede asignarse a menos que se publique. Esta propiedad es de sólo lectura. Se hereda de mobileApp. Los valores posibles son: notPublished, processing y published.
isAssigned	Booleano	Valor que indica si la aplicación está asignada a al menos un grupo. Esta propiedad es de sólo lectura. 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. Esta propiedad es de sólo lectura. Heredado de mobileApp.
supersedingAppCount	Int32	El número total de aplicaciones que esta aplicación reemplaza directa o indirectamente. Esta propiedad es de sólo lectura. Heredado de mobileApp.
supersededAppCount	Int32	El número total de aplicaciones por las que esta aplicación se reemplaza directa o indirectamente. Esta propiedad es de sólo lectura. Heredado de mobileApp.
autoAcceptEula	Booleano	Valor para aceptar automáticamente el CLUF en el dispositivo del usuario final.
productIds	colección officeProductId	Identificadores de producto que representan la SKU de Office365 Suite. Los valores posibles son: o365ProPlusRetail, o365BusinessRetail, visioProRetail y projectProRetail.
excludedApps	excludedApps	Propiedad que representa las aplicaciones que se excluyen del identificador de producto de Office365 seleccionado.
useSharedComputerActivation	Booleano	La propiedad para representar si la activación del equipo compartido no se usa para el conjunto de aplicaciones de Office365.
updateChannel	officeUpdateChannel	Propiedad que representa el canal de actualización de Office365. Los valores posibles son: none, current, deferred, firstReleaseCurrent, firstReleaseDeferred, monthlyEnterprise.
officeSuiteAppDefaultFileFormat	officeSuiteDefaultFileFormatType	Propiedad que representa el tipo de formato de archivo predeterminado de Office365. Los valores posibles son: notConfigured, officeOpenXMLFormat, officeOpenDocumentFormat y unknownFutureValue.
officePlatformArchitecture	windowsArchitecture	Propiedad que representa la versión del conjunto de aplicaciones de Office365. Los valores posibles son: none, x86, x64, arm, neutral, arm64.
localesToInstall	Colección string	Propiedad que representa las configuraciones regionales que se instalan cuando se instalan las aplicaciones de Office365. Usa RFC 6033 estándar. Referencia: https://technet.microsoft.com/library/cc179219(v=office.16).aspx|
installProgressDisplayLevel	officeSuiteInstallProgressDisplayLevel	Para especificar el nivel de visualización de la interfaz de usuario de configuración del progreso de la instalación en el dispositivo. Los valores posibles son none y full.
shouldUninstallOlderVersionsOfOffice	Booleano	Propiedad para determinar si se va a desinstalar msi de Office existente si se implementa un conjunto de aplicaciones de Office365 en el dispositivo o no.
targetVersion	Cadena	Propiedad que representa la versión de destino específica del conjunto de aplicaciones de Office365 que debe permanecer implementada en los dispositivos.
updateVersion	Cadena	Propiedad que representa la versión de actualización en la que la versión de destino específica está disponible para el conjunto de aplicaciones de Office365.
officeConfigurationXml	Binario	Propiedad que representa el archivo de configuración XML que se puede especificar para Office ProPlus Apps. Tiene prioridad sobre todas las demás propiedades. Cuando esté presente, se usará el archivo de configuración XML para crear la aplicación.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto officeSuiteApp actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1736

{
  "@odata.type": "#microsoft.graph.officeSuiteApp",
  "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,
  "autoAcceptEula": true,
  "productIds": [
    "o365BusinessRetail"
  ],
  "excludedApps": {
    "@odata.type": "microsoft.graph.excludedApps",
    "access": true,
    "bing": true,
    "excel": true,
    "groove": true,
    "infoPath": true,
    "lync": true,
    "oneDrive": true,
    "oneNote": true,
    "outlook": true,
    "powerPoint": true,
    "publisher": true,
    "sharePointDesigner": true,
    "teams": true,
    "visio": true,
    "word": true
  },
  "useSharedComputerActivation": true,
  "updateChannel": "current",
  "officeSuiteAppDefaultFileFormat": "officeOpenXMLFormat",
  "officePlatformArchitecture": "x86",
  "localesToInstall": [
    "Locales To Install value"
  ],
  "installProgressDisplayLevel": "full",
  "shouldUninstallOlderVersionsOfOffice": true,
  "targetVersion": "Target Version value",
  "updateVersion": "Update Version value",
  "officeConfigurationXml": "b2ZmaWNlQ29uZmlndXJhdGlvblhtbA=="
}

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 200 OK
Content-Type: application/json
Content-Length: 1908

{
  "@odata.type": "#microsoft.graph.officeSuiteApp",
  "id": "9b263b46-3b46-9b26-463b-269b463b269b",
  "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,
  "autoAcceptEula": true,
  "productIds": [
    "o365BusinessRetail"
  ],
  "excludedApps": {
    "@odata.type": "microsoft.graph.excludedApps",
    "access": true,
    "bing": true,
    "excel": true,
    "groove": true,
    "infoPath": true,
    "lync": true,
    "oneDrive": true,
    "oneNote": true,
    "outlook": true,
    "powerPoint": true,
    "publisher": true,
    "sharePointDesigner": true,
    "teams": true,
    "visio": true,
    "word": true
  },
  "useSharedComputerActivation": true,
  "updateChannel": "current",
  "officeSuiteAppDefaultFileFormat": "officeOpenXMLFormat",
  "officePlatformArchitecture": "x86",
  "localesToInstall": [
    "Locales To Install value"
  ],
  "installProgressDisplayLevel": "full",
  "shouldUninstallOlderVersionsOfOffice": true,
  "targetVersion": "Target Version value",
  "updateVersion": "Update Version value",
  "officeConfigurationXml": "b2ZmaWNlQ29uZmlndXJhdGlvblhtbA=="
}