{ "resources": { "partners": { "resources": { "vendors": { "methods": { "list": { "description": "Lists the vendors of the partner.", "id": "androiddeviceprovisioning.partners.vendors.list", "httpMethod": "GET", "parameters": { "parent": { "pattern": "^partners/[^/]+$", "description": "Required. The resource name in the format `partners/[PARTNER_ID]`.", "location": "path", "required": true, "type": "string" }, "pageSize": { "format": "int32", "description": "The maximum number of results to be returned.", "location": "query", "type": "integer" }, "pageToken": { "description": "A token identifying a page of results returned by the server.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "flatPath": "v1/partners/{partnersId}/vendors", "path": "v1/{+parent}/vendors", "response": { "$ref": "ListVendorsResponse" } } }, "resources": { "customers": { "methods": { "list": { "id": "androiddeviceprovisioning.partners.vendors.customers.list", "description": "Lists the customers of the vendor.", "parameters": { "parent": { "pattern": "^partners/[^/]+/vendors/[^/]+$", "description": "Required. The resource name in the format `partners/[PARTNER_ID]/vendors/[VENDOR_ID]`.", "location": "path", "required": true, "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "The maximum number of results to be returned.", "location": "query" }, "pageToken": { "type": "string", "description": "A token identifying a page of results returned by the server.", "location": "query" } }, "httpMethod": "GET", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/customers", "response": { "$ref": "ListVendorCustomersResponse" }, "flatPath": "v1/partners/{partnersId}/vendors/{vendorsId}/customers" } } } } }, "devices": { "methods": { "claimAsync": { "id": "androiddeviceprovisioning.partners.devices.claimAsync", "httpMethod": "POST", "parameters": { "partnerId": { "pattern": "^[^/]+$", "format": "int64", "description": "Required. The ID of the reseller partner.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "partnerId" ], "flatPath": "v1/partners/{partnersId}/devices:claimAsync", "path": "v1/partners/{+partnerId}/devices:claimAsync", "response": { "$ref": "Operation" }, "description": "Claims a batch of devices for a customer asynchronously. Adds the devices to zero-touch enrollment. To learn more, read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations).", "request": { "$ref": "ClaimDevicesRequest" } }, "unclaim": { "path": "v1/partners/{+partnerId}/devices:unclaim", "response": { "$ref": "Empty" }, "flatPath": "v1/partners/{partnersId}/devices:unclaim", "parameterOrder": [ "partnerId" ], "request": { "$ref": "UnclaimDeviceRequest" }, "description": "Unclaims a device from a customer and removes it from zero-touch enrollment.", "parameters": { "partnerId": { "type": "string", "required": true, "description": "Required. The ID of the reseller partner.", "location": "path", "pattern": "^[^/]+$", "format": "int64" } }, "httpMethod": "POST", "id": "androiddeviceprovisioning.partners.devices.unclaim" }, "claim": { "path": "v1/partners/{+partnerId}/devices:claim", "response": { "$ref": "ClaimDeviceResponse" }, "flatPath": "v1/partners/{partnersId}/devices:claim", "parameterOrder": [ "partnerId" ], "request": { "$ref": "ClaimDeviceRequest" }, "description": "Claims a device for a customer and adds it to zero-touch enrollment. If the device is already claimed by another customer, the call returns an error.", "parameters": { "partnerId": { "type": "string", "required": true, "description": "Required. The ID of the reseller partner.", "location": "path", "pattern": "^[^/]+$", "format": "int64" } }, "httpMethod": "POST", "id": "androiddeviceprovisioning.partners.devices.claim" }, "findByOwner": { "request": { "$ref": "FindDevicesByOwnerRequest" }, "description": "Finds devices claimed for customers. The results only contain devices registered to the reseller that's identified by the `partnerId` argument. The customer's devices purchased from other resellers don't appear in the results.", "path": "v1/partners/{+partnerId}/devices:findByOwner", "response": { "$ref": "FindDevicesByOwnerResponse" }, "flatPath": "v1/partners/{partnersId}/devices:findByOwner", "parameterOrder": [ "partnerId" ], "parameters": { "partnerId": { "description": "Required. The ID of the reseller partner.", "location": "path", "pattern": "^[^/]+$", "format": "int64", "type": "string", "required": true } }, "httpMethod": "POST", "id": "androiddeviceprovisioning.partners.devices.findByOwner" }, "unclaimAsync": { "description": "Unclaims a batch of devices for a customer asynchronously. Removes the devices from zero-touch enrollment. To learn more, read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations).", "request": { "$ref": "UnclaimDevicesRequest" }, "flatPath": "v1/partners/{partnersId}/devices:unclaimAsync", "path": "v1/partners/{+partnerId}/devices:unclaimAsync", "response": { "$ref": "Operation" }, "parameterOrder": [ "partnerId" ], "httpMethod": "POST", "parameters": { "partnerId": { "required": true, "type": "string", "pattern": "^[^/]+$", "format": "int64", "description": "Required. The reseller partner ID.", "location": "path" } }, "id": "androiddeviceprovisioning.partners.devices.unclaimAsync" }, "findByIdentifier": { "httpMethod": "POST", "parameters": { "partnerId": { "required": true, "type": "string", "pattern": "^[^/]+$", "format": "int64", "description": "Required. The ID of the reseller partner.", "location": "path" } }, "id": "androiddeviceprovisioning.partners.devices.findByIdentifier", "description": "Finds devices by hardware identifiers, such as IMEI.", "request": { "$ref": "FindDevicesByDeviceIdentifierRequest" }, "flatPath": "v1/partners/{partnersId}/devices:findByIdentifier", "path": "v1/partners/{+partnerId}/devices:findByIdentifier", "response": { "$ref": "FindDevicesByDeviceIdentifierResponse" }, "parameterOrder": [ "partnerId" ] }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1/partners/{partnersId}/devices/{devicesId}", "path": "v1/{+name}", "response": { "$ref": "Device" }, "description": "Gets a device.", "id": "androiddeviceprovisioning.partners.devices.get", "httpMethod": "GET", "parameters": { "name": { "required": true, "type": "string", "pattern": "^partners/[^/]+/devices/[^/]+$", "description": "Required. The device API resource name in the format `partners/[PARTNER_ID]/devices/[DEVICE_ID]`.", "location": "path" } } }, "updateMetadataAsync": { "id": "androiddeviceprovisioning.partners.devices.updateMetadataAsync", "parameters": { "partnerId": { "description": "Required. The reseller partner ID.", "location": "path", "pattern": "^[^/]+$", "format": "int64", "type": "string", "required": true } }, "httpMethod": "POST", "parameterOrder": [ "partnerId" ], "path": "v1/partners/{+partnerId}/devices:updateMetadataAsync", "response": { "$ref": "Operation" }, "flatPath": "v1/partners/{partnersId}/devices:updateMetadataAsync", "request": { "$ref": "UpdateDeviceMetadataInBatchRequest" }, "description": "Updates the reseller metadata attached to a batch of devices. This method updates devices asynchronously and returns an `Operation` that can be used to track progress. Read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations). Android Devices only." }, "getSimLockState": { "parameterOrder": [ "partnerId" ], "flatPath": "v1/partners/{partnersId}/devices:getSimLockState", "path": "v1/partners/{+partnerId}/devices:getSimLockState", "response": { "$ref": "GetDeviceSimLockStateResponse" }, "description": "Gets a device's SIM lock state.", "request": { "$ref": "GetDeviceSimLockStateRequest" }, "id": "androiddeviceprovisioning.partners.devices.getSimLockState", "httpMethod": "POST", "parameters": { "partnerId": { "type": "string", "required": true, "description": "Required. The ID of the partner.", "location": "path", "pattern": "^[^/]+$", "format": "int64" } } }, "metadata": { "id": "androiddeviceprovisioning.partners.devices.metadata", "parameters": { "metadataOwnerId": { "required": true, "type": "string", "pattern": "^[^/]+$", "format": "int64", "description": "Required. The owner of the newly set metadata. Set this to the partner ID.", "location": "path" }, "deviceId": { "required": true, "type": "string", "pattern": "^[^/]+$", "format": "int64", "description": "Required. The ID of the device.", "location": "path" } }, "httpMethod": "POST", "request": { "$ref": "UpdateDeviceMetadataRequest" }, "description": "Updates reseller metadata associated with the device. Android devices only.", "parameterOrder": [ "metadataOwnerId", "deviceId" ], "path": "v1/partners/{+metadataOwnerId}/devices/{+deviceId}/metadata", "response": { "$ref": "DeviceMetadata" }, "flatPath": "v1/partners/{partnersId}/devices/{devicesId}/metadata" } } }, "customers": { "methods": { "create": { "path": "v1/{+parent}/customers", "response": { "$ref": "Company" }, "flatPath": "v1/partners/{partnersId}/customers", "parameterOrder": [ "parent" ], "request": { "$ref": "CreateCustomerRequest" }, "description": "Creates a customer for zero-touch enrollment. After the method returns successfully, admin and owner roles can manage devices and EMM configs by calling API methods or using their zero-touch enrollment portal. The customer receives an email that welcomes them to zero-touch enrollment and explains how to sign into the portal.", "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The parent resource ID in the format `partners/[PARTNER_ID]` that identifies the reseller.", "location": "path", "pattern": "^partners/[^/]+$" } }, "httpMethod": "POST", "id": "androiddeviceprovisioning.partners.customers.create" }, "list": { "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "type": "integer", "description": "The maximum number of results to be returned. If not specified or 0, all the records are returned.", "location": "query" }, "pageToken": { "type": "string", "description": "A token identifying a page of results returned by the server.", "location": "query" }, "partnerId": { "type": "string", "required": true, "description": "Required. The ID of the reseller partner.", "location": "path", "pattern": "^[^/]+$", "format": "int64" } }, "description": "Lists the customers that are enrolled to the reseller identified by the `partnerId` argument. This list includes customers that the reseller created and customers that enrolled themselves using the portal.", "id": "androiddeviceprovisioning.partners.customers.list", "flatPath": "v1/partners/{partnersId}/customers", "path": "v1/partners/{+partnerId}/customers", "response": { "$ref": "ListCustomersResponse" }, "parameterOrder": [ "partnerId" ] } } } } }, "customers": { "resources": { "devices": { "methods": { "applyConfiguration": { "description": "Applies a Configuration to the device to register the device for zero-touch enrollment. After applying a configuration to a device, the device automatically provisions itself on first boot, or next factory reset.", "request": { "$ref": "CustomerApplyConfigurationRequest" }, "flatPath": "v1/customers/{customersId}/devices:applyConfiguration", "path": "v1/{+parent}/devices:applyConfiguration", "response": { "$ref": "Empty" }, "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The customer managing the device. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path", "pattern": "^customers/[^/]+$" } }, "id": "androiddeviceprovisioning.customers.devices.applyConfiguration" }, "unclaim": { "id": "androiddeviceprovisioning.customers.devices.unclaim", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "description": "Required. The customer managing the device. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path", "required": true, "type": "string" } }, "description": "Unclaims a device from a customer and removes it from zero-touch enrollment. After removing a device, a customer must contact their reseller to register the device into zero-touch enrollment again.", "request": { "$ref": "CustomerUnclaimDeviceRequest" }, "parameterOrder": [ "parent" ], "flatPath": "v1/customers/{customersId}/devices:unclaim", "path": "v1/{+parent}/devices:unclaim", "response": { "$ref": "Empty" } }, "get": { "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "Device" }, "flatPath": "v1/customers/{customersId}/devices/{devicesId}", "id": "androiddeviceprovisioning.customers.devices.get", "description": "Gets the details of a device.", "parameters": { "name": { "required": true, "type": "string", "pattern": "^customers/[^/]+/devices/[^/]+$", "description": "Required. The device to get. An API resource name in the format `customers/[CUSTOMER_ID]/devices/[DEVICE_ID]`.", "location": "path" } }, "httpMethod": "GET" }, "list": { "flatPath": "v1/customers/{customersId}/devices", "path": "v1/{+parent}/devices", "response": { "$ref": "CustomerListDevicesResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The customer managing the devices. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path", "pattern": "^customers/[^/]+$" }, "pageSize": { "format": "int64", "type": "string", "description": "Optional. The maximum number of devices to show in a page of results. If unset or 0, defaults to 1000. If a value greater than 1000 is specified, it will be coerced to 1000.", "location": "query" }, "pageToken": { "description": "A token specifying which result page to return.", "location": "query", "type": "string" } }, "description": "Lists a customer's devices.", "id": "androiddeviceprovisioning.customers.devices.list" }, "removeConfiguration": { "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "description": "Required. The customer managing the device in the format `customers/[CUSTOMER_ID]`.", "location": "path", "required": true, "type": "string" } }, "id": "androiddeviceprovisioning.customers.devices.removeConfiguration", "flatPath": "v1/customers/{customersId}/devices:removeConfiguration", "path": "v1/{+parent}/devices:removeConfiguration", "response": { "$ref": "Empty" }, "parameterOrder": [ "parent" ], "description": "Removes a configuration from device.", "request": { "$ref": "CustomerRemoveConfigurationRequest" } } } }, "dpcs": { "methods": { "list": { "description": "Lists the DPCs (device policy controllers) that support zero-touch enrollment.", "id": "androiddeviceprovisioning.customers.dpcs.list", "httpMethod": "GET", "parameters": { "parent": { "required": true, "type": "string", "pattern": "^customers/[^/]+$", "description": "Required. The customer that can use the DPCs in configurations. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path" } }, "parameterOrder": [ "parent" ], "flatPath": "v1/customers/{customersId}/dpcs", "path": "v1/{+parent}/dpcs", "response": { "$ref": "CustomerListDpcsResponse" } } } }, "configurations": { "methods": { "list": { "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The customer that manages the listed configurations. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path", "pattern": "^customers/[^/]+$" } }, "httpMethod": "GET", "id": "androiddeviceprovisioning.customers.configurations.list", "description": "Lists a customer's configurations.", "path": "v1/{+parent}/configurations", "response": { "$ref": "CustomerListConfigurationsResponse" }, "flatPath": "v1/customers/{customersId}/configurations", "parameterOrder": [ "parent" ] }, "get": { "flatPath": "v1/customers/{customersId}/configurations/{configurationsId}", "path": "v1/{+name}", "response": { "$ref": "Configuration" }, "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "pattern": "^customers/[^/]+/configurations/[^/]+$", "description": "Required. The configuration to get. An API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`.", "location": "path", "required": true, "type": "string" } }, "description": "Gets the details of a configuration.", "id": "androiddeviceprovisioning.customers.configurations.get" }, "patch": { "id": "androiddeviceprovisioning.customers.configurations.patch", "parameters": { "name": { "description": "Output only. The API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by the server.", "location": "path", "pattern": "^customers/[^/]+/configurations/[^/]+$", "type": "string", "required": true }, "updateMask": { "format": "google-fieldmask", "type": "string", "description": "Required. The field mask applied to the target `Configuration` before updating the fields. To learn more about using field masks, read [FieldMask](/protocol-buffers/docs/reference/google.protobuf#fieldmask) in the Protocol Buffers documentation.", "location": "query" } }, "httpMethod": "PATCH", "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "Configuration" }, "flatPath": "v1/customers/{customersId}/configurations/{configurationsId}", "request": { "$ref": "Configuration" }, "description": "Updates a configuration's field values." }, "create": { "parameterOrder": [ "parent" ], "flatPath": "v1/customers/{customersId}/configurations", "path": "v1/{+parent}/configurations", "response": { "$ref": "Configuration" }, "description": "Creates a new configuration. Once created, a customer can apply the configuration to devices.", "request": { "$ref": "Configuration" }, "id": "androiddeviceprovisioning.customers.configurations.create", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "description": "Required. The customer that manages the configuration. An API resource name in the format `customers/[CUSTOMER_ID]`. This field has custom validation in CreateConfigurationRequestValidator", "location": "path", "required": true, "type": "string" } } }, "delete": { "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "Empty" }, "flatPath": "v1/customers/{customersId}/configurations/{configurationsId}", "id": "androiddeviceprovisioning.customers.configurations.delete", "description": "Deletes an unused configuration. The API call fails if the customer has devices with the configuration applied.", "parameters": { "name": { "description": "Required. The configuration to delete. An API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. If the configuration is applied to any devices, the API call fails.", "location": "path", "pattern": "^customers/[^/]+/configurations/[^/]+$", "type": "string", "required": true } }, "httpMethod": "DELETE" } } } }, "methods": { "list": { "parameters": { "pageSize": { "format": "int32", "description": "Required. The maximum number of customers to show in a page of results. A number between 1 and 100 (inclusive).", "location": "query", "type": "integer" }, "pageToken": { "type": "string", "description": "A token specifying which result page to return. This field has custom validations in ListCustomersRequestValidator", "location": "query" } }, "httpMethod": "GET", "id": "androiddeviceprovisioning.customers.list", "description": "Lists the user's customer accounts.", "path": "v1/customers", "response": { "$ref": "CustomerListCustomersResponse" }, "flatPath": "v1/customers", "parameterOrder": [] } } }, "operations": { "methods": { "get": { "id": "androiddeviceprovisioning.operations.get", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "parameters": { "name": { "pattern": "^operations/.*$", "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "path": "v1/{+name}", "response": { "$ref": "Operation" }, "flatPath": "v1/operations/{operationsId}" } } } }, "batchPath": "batch", "title": "Android Device Provisioning Partner API", "schemas": { "DeviceReference": { "properties": { "deviceIdentifier": { "description": "The hardware IDs of the device.", "$ref": "DeviceIdentifier" }, "deviceId": { "format": "int64", "type": "string", "description": "The ID of the device." } }, "id": "DeviceReference", "type": "object", "description": "A `DeviceReference` is an API abstraction that lets you supply a _device_ argument to a method using one of the following identifier types: * A numeric API resource ID. * Real-world hardware IDs, such as IMEI number, belonging to the manufactured device. Methods that operate on devices take a `DeviceReference` as a parameter type because it's more flexible for the caller. To learn more about device identifiers, read [Identifiers](https://developers.google.com/zero-touch/guides/identifiers)." }, "DevicesLongRunningOperationMetadata": { "description": "Tracks the status of a long-running operation to asynchronously update a batch of reseller metadata attached to devices. To learn more, read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations).", "id": "DevicesLongRunningOperationMetadata", "type": "object", "properties": { "processingStatus": { "type": "string", "description": "The processing status of the operation.", "enumDescriptions": [ "Invalid code. Shouldn't be used.", "Pending.", "In progress.", "Processed. This doesn't mean all items were processed successfully, you should check the `response` field for the result of every item." ], "enum": [ "BATCH_PROCESS_STATUS_UNSPECIFIED", "BATCH_PROCESS_PENDING", "BATCH_PROCESS_IN_PROGRESS", "BATCH_PROCESS_PROCESSED" ] }, "devicesCount": { "description": "The number of metadata updates in the operation. This might be different from the number of updates in the request if the API can't parse some of the updates.", "type": "integer", "format": "int32" }, "progress": { "format": "int32", "description": "The processing progress of the operation. Measured as a number from 0 to 100. A value of 10O doesn't always mean the operation completed—check for the inclusion of a `done` field.", "type": "integer" } } }, "CustomerListConfigurationsResponse": { "id": "CustomerListConfigurationsResponse", "type": "object", "description": "Response message of customer's listing configuration.", "properties": { "configurations": { "type": "array", "description": "The configurations.", "items": { "$ref": "Configuration" } } } }, "GoogleWorkspaceAccount": { "properties": { "customerId": { "type": "string", "description": "Required. The customer ID." }, "preProvisioningTokens": { "items": { "type": "string" }, "readOnly": true, "type": "array", "description": "Output only. The pre-provisioning tokens previously used to claim devices." } }, "description": "A Google Workspace customer.", "id": "GoogleWorkspaceAccount", "type": "object" }, "DeviceClaim": { "properties": { "vacationModeStartTime": { "type": "string", "description": "The timestamp when the device was put into ‘vacation mode’. This value is present iff the device is in 'vacation mode'.", "format": "google-datetime" }, "vacationModeExpireTime": { "type": "string", "description": "The timestamp when the device will exit ‘vacation mode’. This value is present iff the device is in 'vacation mode'.", "format": "google-datetime" }, "googleWorkspaceCustomerId": { "type": "string", "description": "The ID of the Google Workspace account that owns the Chrome OS device." }, "ownerCompanyId": { "format": "int64", "type": "string", "description": "The ID of the Customer that purchased the device." }, "resellerId": { "type": "string", "description": "The ID of the reseller that claimed the device.", "format": "int64" }, "sectionType": { "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ], "description": "Output only. The type of claim made on the device.", "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ], "readOnly": true, "type": "string" }, "additionalService": { "enumDescriptions": [ "No additional service.", "Device protection service, also known as Android Enterprise Essentials. To claim a device with the device protection service you must enroll with the partnership team." ], "enum": [ "ADDITIONAL_SERVICE_UNSPECIFIED", "DEVICE_PROTECTION" ], "description": "The Additional service registered for the device.", "type": "string" } }, "id": "DeviceClaim", "type": "object", "description": "A record of a device claimed by a reseller for a customer. Devices claimed for zero-touch enrollment have a claim with the type `SECTION_TYPE_ZERO_TOUCH`. To learn more, read [Claim devices for customers](/zero-touch/guides/how-it-works#claim)." }, "UpdateDeviceMetadataRequest": { "id": "UpdateDeviceMetadataRequest", "type": "object", "description": "Request to set metadata for a device.", "properties": { "deviceMetadata": { "description": "Required. The metadata to attach to the device.", "$ref": "DeviceMetadata" } } }, "Device": { "id": "Device", "type": "object", "description": "An Android or Chrome OS device registered for zero-touch enrollment.", "properties": { "deviceMetadata": { "description": "The metadata attached to the device. Structured as key-value pairs. To learn more, read [Device metadata](https://developers.google.com/zero-touch/guides/metadata).", "$ref": "DeviceMetadata" }, "deviceId": { "type": "string", "description": "Output only. The ID of the device. Assigned by the server.", "format": "int64", "readOnly": true }, "deviceIdentifier": { "description": "The hardware IDs that identify a manufactured device. To learn more, read [Identifiers](https://developers.google.com/zero-touch/guides/identifiers).", "$ref": "DeviceIdentifier" }, "claims": { "description": "Output only. The provisioning claims for a device. Devices claimed for zero-touch enrollment have a claim with the type `SECTION_TYPE_ZERO_TOUCH`. Call `partners.devices.unclaim` or `partners.devices.unclaimAsync` to remove the device from zero-touch enrollment.", "type": "array", "readOnly": true, "items": { "$ref": "DeviceClaim" } }, "name": { "description": "Output only. The API resource name in the format `partners/[PARTNER_ID]/devices/[DEVICE_ID]`. Assigned by the server.", "type": "string", "readOnly": true }, "configuration": { "type": "string", "description": "Not available to resellers." } } }, "DeviceIdentifier": { "properties": { "imei": { "description": "The device’s IMEI number. Validated on input.", "type": "string" }, "meid": { "type": "string", "description": "The device’s MEID number." }, "serialNumber": { "type": "string", "description": "The manufacturer's serial number for the device. This value might not be unique across different device models." }, "deviceType": { "description": "The type of the device", "type": "string", "enumDescriptions": [ "Device type is not specified.", "Android device", "Chrome OS device" ], "enum": [ "DEVICE_TYPE_UNSPECIFIED", "DEVICE_TYPE_ANDROID", "DEVICE_TYPE_CHROME_OS" ] }, "manufacturer": { "type": "string", "description": "The device manufacturer’s name. Matches the device's built-in value returned from `android.os.Build.MANUFACTURER`. Allowed values are listed in [Android manufacturers](/zero-touch/resources/manufacturer-names#manufacturers-names)." }, "model": { "type": "string", "description": "The device model's name. Allowed values are listed in [Android models](/zero-touch/resources/manufacturer-names#model-names) and [Chrome OS models](https://support.google.com/chrome/a/answer/10130175#identify_compatible)." }, "chromeOsAttestedDeviceId": { "description": "An identifier provided by OEMs, carried through the production and sales process. Only applicable to Chrome OS devices.", "type": "string" }, "imei2": { "description": "The device’s second IMEI number.", "type": "string" }, "meid2": { "description": "The device’s second MEID number.", "type": "string" } }, "id": "DeviceIdentifier", "type": "object", "description": "Encapsulates hardware and product IDs to identify a manufactured device. To understand requirements on identifier sets, read [Identifiers](https://developers.google.com/zero-touch/guides/identifiers)." }, "UnclaimDeviceRequest": { "id": "UnclaimDeviceRequest", "type": "object", "description": "Request message to unclaim a device.", "properties": { "vacationModeDays": { "format": "int32", "type": "integer", "description": "The duration of the vacation unlock starting from when the request is processed. (1 day is treated as 24 hours)" }, "deviceIdentifier": { "description": "Required. The device identifier you used when you claimed this device.", "$ref": "DeviceIdentifier" }, "vacationModeExpireTime": { "description": "The expiration time of the vacation unlock.", "type": "string", "format": "google-datetime" }, "deviceId": { "description": "Required. The device ID returned by `ClaimDevice`.", "type": "string", "format": "int64" }, "sectionType": { "type": "string", "description": "Required. The section type of the device's provisioning record.", "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ], "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ] } } }, "FindDevicesByDeviceIdentifierResponse": { "id": "FindDevicesByDeviceIdentifierResponse", "type": "object", "description": "Response containing found devices.", "properties": { "devices": { "items": { "$ref": "Device" }, "description": "Found devices.", "type": "array" }, "totalSize": { "format": "int32", "description": "The total count of items in the list irrespective of pagination.", "type": "integer" }, "nextPageToken": { "description": "A token used to access the next page of results. Omitted if no further results are available.", "type": "string" } } }, "FindDevicesByOwnerResponse": { "properties": { "devices": { "items": { "$ref": "Device" }, "description": "The customer's devices.", "type": "array" }, "totalSize": { "type": "integer", "description": "The total count of items in the list irrespective of pagination.", "format": "int32" }, "nextPageToken": { "description": "A token used to access the next page of results. Omitted if no further results are available.", "type": "string" } }, "id": "FindDevicesByOwnerResponse", "type": "object", "description": "Response containing found devices." }, "UnclaimDevicesRequest": { "id": "UnclaimDevicesRequest", "type": "object", "description": "Request to unclaim devices asynchronously in batch.", "properties": { "unclaims": { "type": "array", "description": "Required. The list of devices to unclaim.", "items": { "$ref": "PartnerUnclaim" } } } }, "CreateCustomerRequest": { "id": "CreateCustomerRequest", "type": "object", "description": "Request message to create a customer.", "properties": { "customer": { "description": "Required. The company data to populate the new customer. Must contain a value for `companyName` and at least one `owner_email` that's associated with a Google Account. The values for `companyId` and `name` must be empty.", "$ref": "Company" } } }, "FindDevicesByOwnerRequest": { "properties": { "pageToken": { "type": "string", "description": "A token specifying which result page to return." }, "googleWorkspaceCustomerId": { "description": "The list of IDs of Google Workspace accounts to search for.", "type": "array", "items": { "type": "string" } }, "customerId": { "items": { "type": "string", "format": "int64" }, "description": "The list of customer IDs to search for.", "type": "array" }, "limit": { "type": "string", "description": "Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive.", "format": "int64" }, "sectionType": { "description": "Required. The section type of the device's provisioning record.", "type": "string", "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ], "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ] } }, "description": "Request to find devices by customers.", "id": "FindDevicesByOwnerRequest", "type": "object" }, "CustomerListDpcsResponse": { "id": "CustomerListDpcsResponse", "type": "object", "description": "Response message of customer's listing DPCs.", "properties": { "dpcs": { "items": { "$ref": "Dpc" }, "description": "The list of DPCs available to the customer that support zero-touch enrollment.", "type": "array" } } }, "CustomerUnclaimDeviceRequest": { "id": "CustomerUnclaimDeviceRequest", "type": "object", "description": "Request message for customer to unclaim a device.", "properties": { "device": { "description": "Required. The device to unclaim. There are custom validations in UnclaimDeviceRequestValidator.", "$ref": "DeviceReference" } } }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", "type": "object", "properties": { "code": { "format": "int32", "type": "integer", "description": "The status code, which should be an enum value of google.rpc.Code." }, "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "details": { "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "type": "array" } } }, "ClaimDeviceResponse": { "description": "Response message containing device id of the claim.", "id": "ClaimDeviceResponse", "type": "object", "properties": { "deviceId": { "description": "The device ID of the claimed device.", "type": "string", "format": "int64" }, "deviceName": { "type": "string", "description": "The resource name of the device in the format `partners/[PARTNER_ID]/devices/[DEVICE_ID]`." } } }, "PerDeviceStatusInBatch": { "properties": { "errorMessage": { "type": "string", "description": "If processing fails, a developer message explaining what went wrong." }, "deviceId": { "format": "int64", "type": "string", "description": "If processing succeeds, the device ID of the device." }, "errorIdentifier": { "description": "If processing fails, the error type.", "type": "string" }, "status": { "type": "string", "description": "The result status of the device after processing.", "enumDescriptions": [ "Invalid code. Shouldn't be used.", "Unknown error. We don't expect this error to occur here.", "Other error. We know/expect this error, but there's no defined error code for the error.", "Success.", "Permission denied.", "Invalid device identifier.", "Invalid section type.", "This section is claimed by another company.", "Invalid pre-provisioning token.", "Revoked pre-provisioning token.", "Status used to indicate a failure due to a device limit being exceeded" ], "enum": [ "SINGLE_DEVICE_STATUS_UNSPECIFIED", "SINGLE_DEVICE_STATUS_UNKNOWN_ERROR", "SINGLE_DEVICE_STATUS_OTHER_ERROR", "SINGLE_DEVICE_STATUS_SUCCESS", "SINGLE_DEVICE_STATUS_PERMISSION_DENIED", "SINGLE_DEVICE_STATUS_INVALID_DEVICE_IDENTIFIER", "SINGLE_DEVICE_STATUS_INVALID_SECTION_TYPE", "SINGLE_DEVICE_STATUS_SECTION_NOT_YOURS", "SINGLE_DEVICE_STATUS_INVALID_TOKEN", "SINGLE_DEVICE_STATUS_REVOKED_TOKEN", "SINGLE_DEVICE_STATUS_DEVICE_LIMIT_EXCEEDED" ] } }, "id": "PerDeviceStatusInBatch", "type": "object", "description": "Captures the processing status for each device in the operation." }, "UpdateDeviceMetadataInBatchRequest": { "id": "UpdateDeviceMetadataInBatchRequest", "type": "object", "description": "Request to update device metadata in batch.", "properties": { "updates": { "items": { "$ref": "UpdateMetadataArguments" }, "type": "array", "description": "Required. The list of metadata updates." } } }, "Operation": { "id": "Operation", "type": "object", "description": "This resource represents a long-running operation that is the result of a network API call.", "properties": { "response": { "description": "This field will contain a `DevicesLongRunningOperationResponse` object if the operation is created by `claimAsync`, `unclaimAsync`, or `updateMetadataAsync`.", "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } }, "metadata": { "type": "object", "description": "This field will contain a `DevicesLongRunningOperationMetadata` object if the operation is created by `claimAsync`, `unclaimAsync`, or `updateMetadataAsync`.", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "name": { "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." }, "error": { "description": "This field will always be not set if the operation is created by `claimAsync`, `unclaimAsync`, or `updateMetadataAsync`. In this case, error information for each device is set in `response.perDeviceStatus.result.status`.", "$ref": "Status" } } }, "GetDeviceSimLockStateRequest": { "description": "Request to get a device's SIM lock status.", "id": "GetDeviceSimLockStateRequest", "type": "object", "properties": { "deviceIdentifier": { "description": "Required. Required. The device identifier to search for.", "$ref": "DeviceIdentifier" } } }, "Configuration": { "properties": { "configurationName": { "description": "Required. A short name that describes the configuration's purpose. For example, _Sales team_ or _Temporary employees_. The zero-touch enrollment portal displays this name to IT admins.", "type": "string" }, "companyName": { "type": "string", "description": "Required. The name of the organization. Zero-touch enrollment shows this organization name to device users during device provisioning." }, "forcedResetTime": { "description": "Optional. The timeout before forcing factory reset the device if the device doesn't go through provisioning in the setup wizard, usually due to lack of network connectivity during setup wizard. Ranges from 0-6 hours, with 2 hours being the default if unset.", "type": "string", "format": "google-duration" }, "name": { "readOnly": true, "type": "string", "description": "Output only. The API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by the server." }, "contactEmail": { "type": "string", "description": "Required. The email address that device users can contact to get help. Zero-touch enrollment shows this email address to device users before device provisioning. The value is validated on input." }, "configurationId": { "format": "int64", "readOnly": true, "type": "string", "description": "Output only. The ID of the configuration. Assigned by the server." }, "customMessage": { "description": "A message, containing one or two sentences, to help device users get help or give them more details about what’s happening to their device. Zero-touch enrollment shows this message before the device is provisioned.", "type": "string" }, "isDefault": { "type": "boolean", "description": "Required. Whether this is the default configuration that zero-touch enrollment applies to any new devices the organization purchases in the future. Only one customer configuration can be the default. Setting this value to `true`, changes the previous default configuration's `isDefault` value to `false`." }, "contactPhone": { "description": "Required. The telephone number that device users can call, using another device, to get help. Zero-touch enrollment shows this number to device users before device provisioning. Accepts numerals, spaces, the plus sign, hyphens, and parentheses.", "type": "string" }, "dpcExtras": { "type": "string", "description": "The JSON-formatted EMM provisioning extras that are passed to the DPC." }, "dpcResourcePath": { "description": "Required. The resource name of the selected DPC (device policy controller) in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs, call `customers.dpcs.list`.", "type": "string" } }, "id": "Configuration", "type": "object", "description": "A configuration collects the provisioning options for Android devices. Each configuration combines the following: * The EMM device policy controller (DPC) installed on the devices. * EMM policies enforced on the devices. * Metadata displayed on the device to help users during setup. Customers can add as many configurations as they need. However, zero-touch enrollment works best when a customer sets a default configuration that's applied to any new devices the organization purchases." }, "ClaimDevicesRequest": { "id": "ClaimDevicesRequest", "type": "object", "description": "Request to claim devices asynchronously in batch. Claiming a device adds the device to zero-touch enrollment and shows the device in the customer's view of the portal.", "properties": { "claims": { "type": "array", "description": "Required. A list of device claims.", "items": { "$ref": "PartnerClaim" } } } }, "CustomerRemoveConfigurationRequest": { "id": "CustomerRemoveConfigurationRequest", "type": "object", "description": "Request message for customer to remove the configuration from device.", "properties": { "device": { "description": "Required. The device to remove the configuration from. There are custom validations in RemoveConfigurationRequestValidator", "$ref": "DeviceReference" } } }, "DeviceMetadata": { "id": "DeviceMetadata", "type": "object", "description": "Metadata entries that can be attached to a `Device`. To learn more, read [Device metadata](https://developers.google.com/zero-touch/guides/metadata).", "properties": { "entries": { "type": "object", "description": "Metadata entries recorded as key-value pairs.", "additionalProperties": { "type": "string" } } } }, "PartnerUnclaim": { "description": "Identifies one unclaim request.", "id": "PartnerUnclaim", "type": "object", "properties": { "vacationModeDays": { "description": "Optional. The duration of the vacation unlock starting from when the request is processed. (1 day is treated as 24 hours)", "type": "integer", "format": "int32" }, "deviceIdentifier": { "description": "Required. Device identifier of the device.", "$ref": "DeviceIdentifier" }, "vacationModeExpireTime": { "format": "google-datetime", "description": "Optional. The expiration time of the vacation unlock.", "type": "string" }, "deviceId": { "format": "int64", "type": "string", "description": "Required. Device ID of the device." }, "sectionType": { "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ], "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ], "description": "Required. The section type of the device's provisioning record.", "type": "string" } } }, "ListVendorCustomersResponse": { "description": "Response message to list customers of the vendor.", "id": "ListVendorCustomersResponse", "type": "object", "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Omitted if no further results are available." }, "totalSize": { "description": "The total count of items in the list irrespective of pagination.", "type": "integer", "format": "int32" }, "customers": { "items": { "$ref": "Company" }, "type": "array", "description": "List of customers of the vendor." } } }, "PartnerClaim": { "properties": { "googleWorkspaceCustomerId": { "type": "string", "description": "The Google Workspace customer ID." }, "preProvisioningToken": { "type": "string", "description": "Optional. Must and can only be set for Chrome OS devices." }, "simlockProfileId": { "type": "string", "description": "Optional. Must and can only be set when DeviceProvisioningSectionType is SECTION_TYPE_SIM_LOCK. The unique identifier of the SimLock profile.", "format": "int64" }, "deviceIdentifier": { "description": "Required. Required. Device identifier of the device.", "$ref": "DeviceIdentifier" }, "sectionType": { "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ], "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ], "type": "string", "description": "Required. The section type of the device's provisioning record." }, "configurationId": { "format": "int64", "description": "Optional. The ID of the configuration applied to the device section.", "type": "string" }, "customerId": { "format": "int64", "description": "The ID of the customer for whom the device is being claimed.", "type": "string" }, "deviceMetadata": { "description": "Required. The metadata to attach to the device at claim.", "$ref": "DeviceMetadata" } }, "id": "PartnerClaim", "type": "object", "description": "Identifies one claim request." }, "CustomerApplyConfigurationRequest": { "properties": { "device": { "description": "Required. The device the configuration is applied to. There are custom validations in ApplyConfigurationRequestValidator", "$ref": "DeviceReference" }, "configuration": { "type": "string", "description": "Required. The configuration applied to the device in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`." } }, "description": "Request message for customer to assign a configuration to device.", "id": "CustomerApplyConfigurationRequest", "type": "object" }, "OperationPerDevice": { "properties": { "unclaim": { "description": "A copy of the original device-unclaim request received by the server.", "$ref": "PartnerUnclaim" }, "updateMetadata": { "description": "A copy of the original metadata-update request received by the server.", "$ref": "UpdateMetadataArguments" }, "result": { "description": "The processing result for each device.", "$ref": "PerDeviceStatusInBatch" }, "claim": { "description": "A copy of the original device-claim request received by the server.", "$ref": "PartnerClaim" } }, "id": "OperationPerDevice", "type": "object", "description": "A task for each device in the operation. Corresponds to each device change in the request." }, "ClaimDeviceRequest": { "id": "ClaimDeviceRequest", "type": "object", "description": "Request message to claim a device on behalf of a customer.", "properties": { "customerId": { "description": "The ID of the customer for whom the device is being claimed.", "type": "string", "format": "int64" }, "deviceMetadata": { "description": "Optional. The metadata to attach to the device.", "$ref": "DeviceMetadata" }, "sectionType": { "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ], "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ], "type": "string", "description": "Required. The section type of the device's provisioning record." }, "configurationId": { "description": "Optional. The ID of the configuration applied to the device section.", "type": "string", "format": "int64" }, "deviceIdentifier": { "description": "Required. Required. The device identifier of the device to claim.", "$ref": "DeviceIdentifier" }, "googleWorkspaceCustomerId": { "description": "The Google Workspace customer ID.", "type": "string" }, "preProvisioningToken": { "description": "Optional. Must and can only be set for Chrome OS devices.", "type": "string" }, "simlockProfileId": { "type": "string", "description": "Optional. Must and can only be set when DeviceProvisioningSectionType is SECTION_TYPE_SIM_LOCK. The unique identifier of the SimLock profile.", "format": "int64" } } }, "GetDeviceSimLockStateResponse": { "properties": { "simLockState": { "enumDescriptions": [ "Invalid code. Shouldn't be used.", "Device is not SIM locked.", "Device is SIM locked to the partner querying SIM lock state.", "Device is SIM locked to a different partner." ], "enum": [ "SIM_LOCK_STATE_UNSPECIFIED", "UNLOCKED", "LOCKED_TO_PARTNER", "LOCKED_TO_OTHER_PARTNER" ], "type": "string" } }, "id": "GetDeviceSimLockStateResponse", "type": "object", "description": "Response containing a device's SimLock state." }, "UpdateMetadataArguments": { "id": "UpdateMetadataArguments", "type": "object", "description": "Identifies metadata updates to one device.", "properties": { "deviceId": { "description": "Required. Device ID of the device.", "type": "string", "format": "int64" }, "deviceIdentifier": { "description": "Required. Device identifier.", "$ref": "DeviceIdentifier" }, "deviceMetadata": { "description": "Required. The metadata to update.", "$ref": "DeviceMetadata" } } }, "CustomerListDevicesResponse": { "properties": { "devices": { "description": "The customer's devices.", "type": "array", "items": { "$ref": "Device" } }, "nextPageToken": { "type": "string", "description": "A token used to access the next page of results. Omitted if no further results are available." } }, "description": "Response message of customer's liting devices.", "id": "CustomerListDevicesResponse", "type": "object" }, "ListCustomersResponse": { "id": "ListCustomersResponse", "type": "object", "description": "Response message of all customers related to this partner.", "properties": { "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Omitted if no further results are available." }, "customers": { "type": "array", "description": "List of customers related to this reseller partner.", "items": { "$ref": "Company" } }, "totalSize": { "format": "int32", "type": "integer", "description": "The total count of items in the list irrespective of pagination." } } }, "ListVendorsResponse": { "id": "ListVendorsResponse", "type": "object", "description": "Response message to list vendors of the partner.", "properties": { "vendors": { "description": "List of vendors of the reseller partner. Fields `name`, `companyId` and `companyName` are populated to the Company object.", "type": "array", "items": { "$ref": "Company" } }, "totalSize": { "description": "The total count of items in the list irrespective of pagination.", "type": "integer", "format": "int32" }, "nextPageToken": { "type": "string", "description": "A token to retrieve the next page of results. Omitted if no further results are available." } } }, "CustomerListCustomersResponse": { "properties": { "nextPageToken": { "description": "A token used to access the next page of results. Omitted if no further results are available.", "type": "string" }, "customers": { "description": "The customer accounts the calling user is a member of.", "type": "array", "items": { "$ref": "Company" } } }, "id": "CustomerListCustomersResponse", "type": "object", "description": "Response message for listing my customers." }, "FindDevicesByDeviceIdentifierRequest": { "properties": { "pageToken": { "description": "A token specifying which result page to return.", "type": "string" }, "limit": { "type": "string", "description": "Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive.", "format": "int64" }, "deviceIdentifier": { "description": "Required. Required. The device identifier to search for. If serial number is provided then case insensitive serial number matches are allowed.", "$ref": "DeviceIdentifier" } }, "description": "Request to find devices.", "id": "FindDevicesByDeviceIdentifierRequest", "type": "object" }, "Company": { "description": "A reseller, vendor, or customer in the zero-touch reseller and customer APIs.", "id": "Company", "type": "object", "properties": { "name": { "readOnly": true, "description": "Output only. The API resource name of the company. The resource name is one of the following formats: * `partners/[PARTNER_ID]/customers/[CUSTOMER_ID]` * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]` * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]` Assigned by the server.", "type": "string" }, "ownerEmails": { "type": "array", "description": "Required. Input only. Email address of customer's users in the owner role. At least one `owner_email` is required. Owners share the same access as admins but can also add, delete, and edit your organization's portal users.", "items": { "type": "string" } }, "adminEmails": { "items": { "type": "string" }, "description": "Optional. Email address of customer's users in the admin role. Each email address must be associated with a Google Account.", "type": "array" }, "skipWelcomeEmail": { "type": "boolean", "description": "Input only. If set to true, welcome email will not be sent to the customer. It is recommended to skip the welcome email if devices will be claimed with additional DEVICE_PROTECTION service, as the customer will receive separate emails at device claim time. This field is ignored if this is not a Zero-touch customer." }, "companyName": { "description": "Required. The name of the company. For example _XYZ Corp_. Displayed to the company's employees in the zero-touch enrollment portal.", "type": "string" }, "termsStatus": { "description": "Output only. Whether any user from the company has accepted the latest Terms of Service (ToS). See TermsStatus.", "enumDescriptions": [ "Default value. This value should never be set if the enum is present.", "None of the company's users have accepted the ToS.", "One (or more) of the company's users has accepted the ToS.", "None of the company's users has accepted the current ToS but at least one user accepted a previous ToS." ], "type": "string", "enum": [ "TERMS_STATUS_UNSPECIFIED", "TERMS_STATUS_NOT_ACCEPTED", "TERMS_STATUS_ACCEPTED", "TERMS_STATUS_STALE" ], "readOnly": true }, "languageCode": { "description": "Input only. The preferred locale of the customer represented as a BCP47 language code. This field is validated on input and requests containing unsupported language codes will be rejected. Supported language codes: Arabic (ar) Chinese (Hong Kong) (zh-HK) Chinese (Simplified) (zh-CN) Chinese (Traditional) (zh-TW) Czech (cs) Danish (da) Dutch (nl) English (UK) (en-GB) English (US) (en-US) Filipino (fil) Finnish (fi) French (fr) German (de) Hebrew (iw) Hindi (hi) Hungarian (hu) Indonesian (id) Italian (it) Japanese (ja) Korean (ko) Norwegian (Bokmal) (no) Polish (pl) Portuguese (Brazil) (pt-BR) Portuguese (Portugal) (pt-PT) Russian (ru) Spanish (es) Spanish (Latin America) (es-419) Swedish (sv) Thai (th) Turkish (tr) Ukrainian (uk) Vietnamese (vi)", "type": "string" }, "googleWorkspaceAccount": { "description": "Output only. The Google Workspace account associated with this customer. Only used for customer Companies.", "readOnly": true, "$ref": "GoogleWorkspaceAccount" }, "companyId": { "readOnly": true, "format": "int64", "description": "Output only. The ID of the company. Assigned by the server.", "type": "string" } } }, "Empty": { "id": "Empty", "type": "object", "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "properties": {} }, "Dpc": { "properties": { "dpcName": { "description": "Output only. The title of the DPC app in Google Play. For example, _Google Apps Device Policy_. Useful in an application's user interface.", "type": "string", "readOnly": true }, "name": { "description": "Output only. The API resource name in the format `customers/[CUSTOMER_ID]/dpcs/[DPC_ID]`. Assigned by the server. To maintain a reference to a DPC across customer accounts, persist and match the last path component (`DPC_ID`).", "type": "string", "readOnly": true }, "packageName": { "readOnly": true, "description": "Output only. The DPC's Android application ID that looks like a Java package name. Zero-touch enrollment installs the DPC app onto a device using this identifier.", "type": "string" } }, "description": "An EMM's DPC ([device policy controller](http://developer.android.com/work/dpc/build-dpc.html)). Zero-touch enrollment installs a DPC (listed in the `Configuration`) on a device to maintain the customer's mobile policies. All the DPCs listed by the API support zero-touch enrollment and are available in Google Play.", "id": "Dpc", "type": "object" }, "DevicesLongRunningOperationResponse": { "properties": { "successCount": { "type": "integer", "description": "A summary of how many items in the operation the server processed successfully. Updated as the operation progresses.", "format": "int32" }, "perDeviceStatus": { "items": { "$ref": "OperationPerDevice" }, "description": "The processing status for each device in the operation. One `PerDeviceStatus` per device. The list order matches the items in the original request.", "type": "array" } }, "description": "Tracks the status of a long-running operation to claim, unclaim, or attach metadata to devices. To learn more, read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations).", "id": "DevicesLongRunningOperationResponse", "type": "object" } }, "id": "androiddeviceprovisioning:v1", "discoveryVersion": "v1", "mtlsRootUrl": "https://androiddeviceprovisioning.mtls.googleapis.com/", "parameters": { "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "key": { "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query" }, "$.xgafv": { "enum": [ "1", "2" ], "type": "string", "enumDescriptions": [ "v1 error format", "v2 error format" ], "description": "V1 error format.", "location": "query" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "alt": { "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "description": "Data format for response.", "default": "json", "location": "query", "enum": [ "json", "media", "proto" ], "type": "string" }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query", "type": "string" }, "callback": { "type": "string", "description": "JSONP", "location": "query" } }, "kind": "discovery#restDescription", "description": "Automates Android zero-touch enrollment for device resellers, customers, and EMMs.", "ownerName": "Google", "ownerDomain": "google.com", "basePath": "", "revision": "20260721", "documentationLink": "https://developers.google.com/zero-touch/", "rootUrl": "https://androiddeviceprovisioning.googleapis.com/", "canonicalName": "Android Provisioning Partner", "version": "v1", "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "fullyEncodeReservedExpansion": true, "version_module": true, "baseUrl": "https://androiddeviceprovisioning.googleapis.com/", "servicePath": "", "name": "androiddeviceprovisioning", "protocol": "rest" }