Objetos

CompanyReference

Identifica de manera inequívoca a una empresa.

Nombre del campo Tipo de datos Descripción
companyId string Solo salida. El ID de la empresa, que asigna el servidor.
vendor enum Samsung o Google.

Empresa

Representa a una empresa.

Nombre del campo Tipo de datos Descripción
companyReference object(CompanyReference) Objeto de referencia de la empresa.
companyName string Es el nombre de la empresa. Por ejemplo, XYZ Corp. Se muestra a los empleados de la empresa en el portal de inscripción automática.
vendorParams map Campos adicionales en pares clave-valor especificados por el proveedor.

Dispositivo

Un dispositivo Android registrado para la inscripción

Nombre del campo Tipo de datos Descripción
deviceId string Solo salida. Es el ID del dispositivo que asigna el servidor.
deviceIdentifier object(DeviceIdentifier) Son los IDs de hardware que identifican a un dispositivo fabricado.
customer object(CompanyReference) Los IDs de la empresa que identifican a qué empresa se asignaron los dispositivos.
orderNumber string Indica el número de pedido.
vendorParams map Campos adicionales en pares clave-valor especificados por el proveedor.

DeviceIdentifier

Encapsula los IDs del producto y el hardware para identificar el dispositivo del fabricante.

Los dispositivos Samsung requieren uno de los siguientes campos:

  • IMEI
  • serialNumber
  • meid

Se ignoran todos los demás campos, como model.

Para todos los demás dispositivos Android:

  • Los dispositivos móviles requieren imei y manufacturer.
  • Los dispositivos que solo usan Wi-Fi requieren serialNumber, manufacturer y model.
Nombre del campo Tipo de datos Descripción
imei string El número IMEI del dispositivo. Se valida en la entrada.
serialNumber string Es el número de serie del fabricante del dispositivo. Es posible que este valor no sea único en diferentes modelos de dispositivos.
meid string Es el número MEID del dispositivo.
manufacturer string Es el nombre del fabricante del dispositivo. Coincide con el valor integrado del dispositivo que muestra android.os.Build.MANUFACTURER. Los valores permitidos se enumeran en manufacturers.
model string El nombre del modelo del dispositivo. Coincide con el valor integrado del dispositivo que muestra android.os.Build.MODEL. Los valores permitidos se enumeran en modelos.

Operación

Este recurso contiene el estado de una llamada a la API asíncrona. Existen cuatro estados posibles:

  • IN_PROGRESS: La operación está en curso.
  • COMPLETE: Se procesaron correctamente todos los dispositivos.
  • COMPLETE_WITH_ERRORS: La operación se procesó, pero se produjeron algunos errores. Todos los errores se muestran en la lista deviceErrors.
  • FAILED: La operación falló y no se muestra ningún operationId.
Nombre del campo Tipo de datos Descripción
operationId string El ID de operación, con el prefijo samsung/ o google/. Si está vacío,state es FAILED.
operationType enum(operationType) El tipo de operación: CLAIM_DEVICES o UNCLAIM_DEVICES.
state enum(operationState) El estado de la operación: IN_PROGRESS, COMPLETE, COMPLETE_WITH_ERRORS, FAILED.
deviceErrors Lista de object(DeviceOperationError) Lista de errores de operación del dispositivo.
vendorParams map Campos adicionales en pares clave-valor especificados por el proveedor.

DeviceOperationError

Es un error específico del dispositivo en una Operation. Cada recurso contiene la misma deviceId y deviceIdentifier como la solicitud que inició la operación.

Nombre del campo Tipo de datos Descripción
deviceId string Solo salida. Es el ID del dispositivo que asigna el servidor.
deviceIdentifier object(DeviceIdentifier) Son los IDs de hardware que identifican a un dispositivo fabricado.
error object(Error) El error de operación del dispositivo.

CommonException

Una excepción que pueden arrojar todas las APIs síncronas.

Nombre de la propiedad Valor Descripción
error object(Error) Se produjo un error de operación síncrona.

Error

Un objeto que contiene detalles sobre un error.

Nombre de la propiedad Valor Descripción
code enum(ErrorCode) Es el código de error. Por ejemplo, INVALID_REQUESET o PERMISSION_DENIED.
message string Mensaje de error.
vendorMsg string Una explicación detallada del error del proveedor.
errorId string El identificador de error interno.
vendorParams map Campos adicionales en pares clave-valor especificados por el proveedor.

ErrorCode

Errores comunes.

Enum Descripción
INVALID_PARAM_DEFAULT Parámetro de entrada no válido no especificado. Para obtener más detalles, consulta providerMsg.
INVALID_PAGE_TOKEN El pageToken que se proporcionó no es válido.
INVALID_CUSTOMER_ID El ID de cliente proporcionado no es válido.
INVALID_DEVICE_IMEI El IMEI no es válido.
INVALID_DEVICE_MEID El MEID no es válido.
INVALID_DEVICE_SERIAL El número de serie no es válido.
INVALID_OPERATION_ID El operationsId proporcionado no es válido.
INVALID_RESELLER_ID El revendedorId proporcionado no es válido.
INVALID_MANUFACTURER El fabricante que proporcionaste no es válido o no es compatible.
INVALID_IDENTIFIER_SET El conjunto de identificadores proporcionados no es suficiente para la solicitud. Consulta DeviceIdentifier para obtener más información sobre los conjuntos de identificadores permitidos.
INVALID_MODEL El modelo proporcionado no es válido o no es compatible.
INVALID_DEVICE_ID El deviceId proporcionado no es válido.
INVALID_DEVICE El dispositivo proporcionado no existe. Este es un código de error específico de Samsung.
DUPLICATE_DEVICE Ya se reclamó el dispositivo al mismo cliente. No se requiere ninguna acción correctiva.
DEVICE_UPLOAD_COUNT_EXCEEDED La solicitud incluye más dispositivos que el límite (actualmente, 100,000).
AUTHORIZATION_FAIL No tienes acceso a un recurso determinado (p.ej., un dispositivo o un cliente) o el recurso no existe. Consulta vendorMsg para obtener más detalles.
INTERNAL_SERVER_ERROR Error interno del servidor no especificado. Consulta providerMsg para obtener más detalles. Estas solicitudes se pueden reintentar según la naturaleza del error del servidor.
NOT_IMPLEMENTED El servidor no admite el método de solicitud.