{ "kind": "discovery#restDescription", "protocol": "rest", "mtlsRootUrl": "https://androiddeviceprovisioning.mtls.googleapis.com/", "id": "androiddeviceprovisioning:v1", "servicePath": "", "canonicalName": "Android Provisioning Partner", "title": "Android Device Provisioning Partner API", "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "schemas": { "DeviceClaim": { "id": "DeviceClaim", "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).", "type": "object", "properties": { "vacationModeStartTime": { "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", "type": "string" }, "ownerCompanyId": { "format": "int64", "description": "The ID of the Customer that purchased the device.", "type": "string" }, "resellerId": { "format": "int64", "description": "The ID of the reseller that claimed the device.", "type": "string" }, "additionalService": { "enum": [ "ADDITIONAL_SERVICE_UNSPECIFIED", "DEVICE_PROTECTION" ], "type": "string", "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." ], "description": "The Additional service registered for the device." }, "googleWorkspaceCustomerId": { "description": "The ID of the Google Workspace account that owns the Chrome OS device.", "type": "string" }, "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" }, "sectionType": { "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ], "readOnly": true, "description": "Output only. The type of claim made on the device.", "type": "string", "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ] } } }, "Empty": { "type": "object", "properties": {}, "id": "Empty", "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); }" }, "UpdateDeviceMetadataInBatchRequest": { "type": "object", "properties": { "updates": { "description": "Required. The list of metadata updates.", "items": { "$ref": "UpdateMetadataArguments" }, "type": "array" } }, "id": "UpdateDeviceMetadataInBatchRequest", "description": "Request to update device metadata in batch." }, "ClaimDeviceRequest": { "id": "ClaimDeviceRequest", "description": "Request message to claim a device on behalf of a customer.", "type": "object", "properties": { "customerId": { "type": "string", "description": "The ID of the customer for whom the device is being claimed.", "format": "int64" }, "preProvisioningToken": { "description": "Optional. Must and can only be set for Chrome OS devices.", "type": "string" }, "simlockProfileId": { "type": "string", "format": "int64", "description": "Optional. Must and can only be set when DeviceProvisioningSectionType is SECTION_TYPE_SIM_LOCK. The unique identifier of the SimLock profile." }, "sectionType": { "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": "Required. The section type of the device's provisioning record." }, "deviceMetadata": { "description": "Optional. The metadata to attach to the device.", "$ref": "DeviceMetadata" }, "configurationId": { "description": "Optional. The ID of the configuration applied to the device section.", "format": "int64", "type": "string" }, "googleWorkspaceCustomerId": { "description": "The Google Workspace customer ID.", "type": "string" }, "deviceIdentifier": { "description": "Required. Required. The device identifier of the device to claim.", "$ref": "DeviceIdentifier" } } }, "UnclaimDeviceRequest": { "type": "object", "properties": { "deviceId": { "format": "int64", "description": "Required. The device ID returned by `ClaimDevice`.", "type": "string" }, "vacationModeExpireTime": { "description": "The expiration time of the vacation unlock.", "format": "google-datetime", "type": "string" }, "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" ] }, "deviceIdentifier": { "description": "Required. The device identifier you used when you claimed this device.", "$ref": "DeviceIdentifier" }, "vacationModeDays": { "type": "integer", "description": "The duration of the vacation unlock starting from when the request is processed. (1 day is treated as 24 hours)", "format": "int32" } }, "id": "UnclaimDeviceRequest", "description": "Request message to unclaim a device." }, "GetDeviceSimLockStateResponse": { "id": "GetDeviceSimLockStateResponse", "description": "Response containing a device's SimLock state.", "type": "object", "properties": { "simLockState": { "type": "string", "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" ] } } }, "ClaimDevicesRequest": { "type": "object", "properties": { "claims": { "description": "Required. A list of device claims.", "items": { "$ref": "PartnerClaim" }, "type": "array" } }, "id": "ClaimDevicesRequest", "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." }, "CustomerListConfigurationsResponse": { "id": "CustomerListConfigurationsResponse", "description": "Response message of customer's listing configuration.", "type": "object", "properties": { "configurations": { "type": "array", "description": "The configurations.", "items": { "$ref": "Configuration" } } } }, "CustomerListDevicesResponse": { "type": "object", "properties": { "devices": { "type": "array", "description": "The customer's devices.", "items": { "$ref": "Device" } }, "nextPageToken": { "description": "A token used to access the next page of results. Omitted if no further results are available.", "type": "string" } }, "id": "CustomerListDevicesResponse", "description": "Response message of customer's liting devices." }, "Device": { "id": "Device", "description": "An Android or Chrome OS device registered for zero-touch enrollment.", "type": "object", "properties": { "deviceId": { "readOnly": true, "type": "string", "format": "int64", "description": "Output only. The ID of the device. Assigned by the server." }, "name": { "readOnly": true, "type": "string", "description": "Output only. The API resource name in the format `partners/[PARTNER_ID]/devices/[DEVICE_ID]`. Assigned by the server." }, "configuration": { "description": "Not available to resellers.", "type": "string" }, "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" }, "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.", "items": { "$ref": "DeviceClaim" }, "readOnly": true, "type": "array" } } }, "DeviceIdentifier": { "type": "object", "properties": { "meid2": { "description": "The device’s second MEID number.", "type": "string" }, "meid": { "description": "The device’s MEID number.", "type": "string" }, "manufacturer": { "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).", "type": "string" }, "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" }, "model": { "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).", "type": "string" }, "imei": { "description": "The device’s IMEI number. Validated on input.", "type": "string" }, "serialNumber": { "description": "The manufacturer's serial number for the device. This value might not be unique across different device models.", "type": "string" }, "deviceType": { "type": "string", "enumDescriptions": [ "Device type is not specified.", "Android device", "Chrome OS device" ], "enum": [ "DEVICE_TYPE_UNSPECIFIED", "DEVICE_TYPE_ANDROID", "DEVICE_TYPE_CHROME_OS" ], "description": "The type of the device" } }, "id": "DeviceIdentifier", "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)." }, "FindDevicesByOwnerRequest": { "id": "FindDevicesByOwnerRequest", "description": "Request to find devices by customers.", "type": "object", "properties": { "customerId": { "type": "array", "description": "The list of customer IDs to search for.", "items": { "format": "int64", "type": "string" } }, "limit": { "description": "Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive.", "format": "int64", "type": "string" }, "sectionType": { "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ], "type": "string", "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ], "description": "Required. The section type of the device's provisioning record." }, "pageToken": { "description": "A token specifying which result page to return.", "type": "string" }, "googleWorkspaceCustomerId": { "type": "array", "description": "The list of IDs of Google Workspace accounts to search for.", "items": { "type": "string" } } } }, "Status": { "id": "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).", "type": "object", "properties": { "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" }, "code": { "type": "integer", "format": "int32", "description": "The status code, which should be an enum value of google.rpc.Code." }, "details": { "type": "array", "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" } } } }, "Configuration": { "type": "object", "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" }, "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" }, "dpcExtras": { "description": "The JSON-formatted EMM provisioning extras that are passed to the DPC.", "type": "string" }, "forcedResetTime": { "type": "string", "format": "google-duration", "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." }, "companyName": { "description": "Required. The name of the organization. Zero-touch enrollment shows this organization name to device users during device provisioning.", "type": "string" }, "contactEmail": { "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.", "type": "string" }, "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" }, "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" }, "configurationId": { "format": "int64", "description": "Output only. The ID of the configuration. Assigned by the server.", "readOnly": true, "type": "string" }, "name": { "description": "Output only. The API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by the server.", "readOnly": true, "type": "string" }, "isDefault": { "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`.", "type": "boolean" } }, "id": "Configuration", "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." }, "ListVendorsResponse": { "type": "object", "properties": { "totalSize": { "description": "The total count of items in the list irrespective of pagination.", "format": "int32", "type": "integer" }, "vendors": { "type": "array", "description": "List of vendors of the reseller partner. Fields `name`, `companyId` and `companyName` are populated to the Company object.", "items": { "$ref": "Company" } }, "nextPageToken": { "description": "A token to retrieve the next page of results. Omitted if no further results are available.", "type": "string" } }, "id": "ListVendorsResponse", "description": "Response message to list vendors of the partner." }, "OperationPerDevice": { "id": "OperationPerDevice", "description": "A task for each device in the operation. Corresponds to each device change in the request.", "type": "object", "properties": { "claim": { "description": "A copy of the original device-claim request received by the server.", "$ref": "PartnerClaim" }, "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" } } }, "GetDeviceSimLockStateRequest": { "type": "object", "properties": { "deviceIdentifier": { "description": "Required. Required. The device identifier to search for.", "$ref": "DeviceIdentifier" } }, "id": "GetDeviceSimLockStateRequest", "description": "Request to get a device's SIM lock status." }, "Dpc": { "type": "object", "properties": { "name": { "readOnly": true, "type": "string", "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`)." }, "packageName": { "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.", "readOnly": true, "type": "string" }, "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.", "readOnly": true, "type": "string" } }, "id": "Dpc", "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." }, "CustomerRemoveConfigurationRequest": { "type": "object", "properties": { "device": { "description": "Required. The device to remove the configuration from. There are custom validations in RemoveConfigurationRequestValidator", "$ref": "DeviceReference" } }, "id": "CustomerRemoveConfigurationRequest", "description": "Request message for customer to remove the configuration from device." }, "DeviceMetadata": { "id": "DeviceMetadata", "description": "Metadata entries that can be attached to a `Device`. To learn more, read [Device metadata](https://developers.google.com/zero-touch/guides/metadata).", "type": "object", "properties": { "entries": { "description": "Metadata entries recorded as key-value pairs.", "additionalProperties": { "type": "string" }, "type": "object" } } }, "Operation": { "id": "Operation", "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "properties": { "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": { "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.", "type": "boolean" }, "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "This field will contain a `DevicesLongRunningOperationResponse` object if the operation is created by `claimAsync`, `unclaimAsync`, or `updateMetadataAsync`." }, "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" }, "metadata": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object", "description": "This field will contain a `DevicesLongRunningOperationMetadata` object if the operation is created by `claimAsync`, `unclaimAsync`, or `updateMetadataAsync`." } } }, "PerDeviceStatusInBatch": { "id": "PerDeviceStatusInBatch", "description": "Captures the processing status for each device in the operation.", "type": "object", "properties": { "errorMessage": { "description": "If processing fails, a developer message explaining what went wrong.", "type": "string" }, "deviceId": { "format": "int64", "description": "If processing succeeds, the device ID of the device.", "type": "string" }, "status": { "type": "string", "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" ], "description": "The result status of the device after processing." }, "errorIdentifier": { "description": "If processing fails, the error type.", "type": "string" } } }, "ListCustomersResponse": { "id": "ListCustomersResponse", "description": "Response message of all customers related to this partner.", "type": "object", "properties": { "nextPageToken": { "description": "A token to retrieve the next page of results. Omitted if no further results are available.", "type": "string" }, "customers": { "type": "array", "description": "List of customers related to this reseller partner.", "items": { "$ref": "Company" } }, "totalSize": { "format": "int32", "description": "The total count of items in the list irrespective of pagination.", "type": "integer" } } }, "PartnerClaim": { "type": "object", "properties": { "customerId": { "format": "int64", "description": "The ID of the customer for whom the device is being claimed.", "type": "string" }, "preProvisioningToken": { "description": "Optional. Must and can only be set for Chrome OS devices.", "type": "string" }, "simlockProfileId": { "description": "Optional. Must and can only be set when DeviceProvisioningSectionType is SECTION_TYPE_SIM_LOCK. The unique identifier of the SimLock profile.", "format": "int64", "type": "string" }, "deviceIdentifier": { "description": "Required. Required. Device identifier of the device.", "$ref": "DeviceIdentifier" }, "sectionType": { "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": "Required. The section type of the device's provisioning record." }, "deviceMetadata": { "description": "Required. The metadata to attach to the device at claim.", "$ref": "DeviceMetadata" }, "configurationId": { "type": "string", "format": "int64", "description": "Optional. The ID of the configuration applied to the device section." }, "googleWorkspaceCustomerId": { "description": "The Google Workspace customer ID.", "type": "string" } }, "id": "PartnerClaim", "description": "Identifies one claim request." }, "CustomerListDpcsResponse": { "type": "object", "properties": { "dpcs": { "description": "The list of DPCs available to the customer that support zero-touch enrollment.", "items": { "$ref": "Dpc" }, "type": "array" } }, "id": "CustomerListDpcsResponse", "description": "Response message of customer's listing DPCs." }, "FindDevicesByDeviceIdentifierRequest": { "type": "object", "properties": { "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" }, "pageToken": { "description": "A token specifying which result page to return.", "type": "string" }, "limit": { "format": "int64", "description": "Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive.", "type": "string" } }, "id": "FindDevicesByDeviceIdentifierRequest", "description": "Request to find devices." }, "CustomerApplyConfigurationRequest": { "id": "CustomerApplyConfigurationRequest", "description": "Request message for customer to assign a configuration to device.", "type": "object", "properties": { "configuration": { "description": "Required. The configuration applied to the device in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`.", "type": "string" }, "device": { "description": "Required. The device the configuration is applied to. There are custom validations in ApplyConfigurationRequestValidator", "$ref": "DeviceReference" } } }, "DevicesLongRunningOperationResponse": { "type": "object", "properties": { "successCount": { "format": "int32", "description": "A summary of how many items in the operation the server processed successfully. Updated as the operation progresses.", "type": "integer" }, "perDeviceStatus": { "type": "array", "description": "The processing status for each device in the operation. One `PerDeviceStatus` per device. The list order matches the items in the original request.", "items": { "$ref": "OperationPerDevice" } } }, "id": "DevicesLongRunningOperationResponse", "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)." }, "Company": { "id": "Company", "description": "A reseller, vendor, or customer in the zero-touch reseller and customer APIs.", "type": "object", "properties": { "skipWelcomeEmail": { "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.", "type": "boolean" }, "googleWorkspaceAccount": { "description": "Output only. The Google Workspace account associated with this customer. Only used for customer Companies.", "$ref": "GoogleWorkspaceAccount", "readOnly": true }, "companyId": { "description": "Output only. The ID of the company. Assigned by the server.", "format": "int64", "readOnly": true, "type": "string" }, "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" }, "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" } }, "termsStatus": { "enum": [ "TERMS_STATUS_UNSPECIFIED", "TERMS_STATUS_NOT_ACCEPTED", "TERMS_STATUS_ACCEPTED", "TERMS_STATUS_STALE" ], "readOnly": true, "description": "Output only. Whether any user from the company has accepted the latest Terms of Service (ToS). See TermsStatus.", "type": "string", "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." ] }, "adminEmails": { "type": "array", "description": "Optional. Email address of customer's users in the admin role. Each email address must be associated with a Google Account.", "items": { "type": "string" } }, "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" }, "name": { "readOnly": true, "type": "string", "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." } } }, "FindDevicesByDeviceIdentifierResponse": { "id": "FindDevicesByDeviceIdentifierResponse", "description": "Response containing found devices.", "type": "object", "properties": { "nextPageToken": { "description": "A token used to access the next page of results. Omitted if no further results are available.", "type": "string" }, "devices": { "type": "array", "description": "Found devices.", "items": { "$ref": "Device" } }, "totalSize": { "description": "The total count of items in the list irrespective of pagination.", "format": "int32", "type": "integer" } } }, "UnclaimDevicesRequest": { "id": "UnclaimDevicesRequest", "description": "Request to unclaim devices asynchronously in batch.", "type": "object", "properties": { "unclaims": { "description": "Required. The list of devices to unclaim.", "items": { "$ref": "PartnerUnclaim" }, "type": "array" } } }, "ClaimDeviceResponse": { "id": "ClaimDeviceResponse", "description": "Response message containing device id of the claim.", "type": "object", "properties": { "deviceId": { "description": "The device ID of the claimed device.", "format": "int64", "type": "string" }, "deviceName": { "description": "The resource name of the device in the format `partners/[PARTNER_ID]/devices/[DEVICE_ID]`.", "type": "string" } } }, "CreateCustomerRequest": { "type": "object", "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" } }, "id": "CreateCustomerRequest", "description": "Request message to create a customer." }, "UpdateDeviceMetadataRequest": { "type": "object", "properties": { "deviceMetadata": { "description": "Required. The metadata to attach to the device.", "$ref": "DeviceMetadata" } }, "id": "UpdateDeviceMetadataRequest", "description": "Request to set metadata for a device." }, "DevicesLongRunningOperationMetadata": { "id": "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).", "type": "object", "properties": { "devicesCount": { "format": "int32", "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" }, "progress": { "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.", "format": "int32", "type": "integer" }, "processingStatus": { "description": "The processing status of the operation.", "type": "string", "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" ] } } }, "GoogleWorkspaceAccount": { "id": "GoogleWorkspaceAccount", "description": "A Google Workspace customer.", "type": "object", "properties": { "preProvisioningTokens": { "description": "Output only. The pre-provisioning tokens previously used to claim devices.", "items": { "type": "string" }, "readOnly": true, "type": "array" }, "customerId": { "description": "Required. The customer ID.", "type": "string" } } }, "UpdateMetadataArguments": { "id": "UpdateMetadataArguments", "description": "Identifies metadata updates to one device.", "type": "object", "properties": { "deviceMetadata": { "description": "Required. The metadata to update.", "$ref": "DeviceMetadata" }, "deviceId": { "type": "string", "format": "int64", "description": "Required. Device ID of the device." }, "deviceIdentifier": { "description": "Required. Device identifier.", "$ref": "DeviceIdentifier" } } }, "CustomerListCustomersResponse": { "id": "CustomerListCustomersResponse", "description": "Response message for listing my customers.", "type": "object", "properties": { "customers": { "description": "The customer accounts the calling user is a member of.", "items": { "$ref": "Company" }, "type": "array" }, "nextPageToken": { "description": "A token used to access the next page of results. Omitted if no further results are available.", "type": "string" } } }, "PartnerUnclaim": { "id": "PartnerUnclaim", "description": "Identifies one unclaim request.", "type": "object", "properties": { "deviceId": { "description": "Required. Device ID of the device.", "format": "int64", "type": "string" }, "vacationModeExpireTime": { "type": "string", "format": "google-datetime", "description": "Optional. The expiration time of the vacation unlock." }, "sectionType": { "description": "Required. The section type of the device's provisioning record.", "enum": [ "SECTION_TYPE_UNSPECIFIED", "SECTION_TYPE_SIM_LOCK", "SECTION_TYPE_ZERO_TOUCH" ], "type": "string", "enumDescriptions": [ "Unspecified section type.", "SIM-lock section type.", "Zero-touch enrollment section type." ] }, "deviceIdentifier": { "description": "Required. Device identifier of the device.", "$ref": "DeviceIdentifier" }, "vacationModeDays": { "type": "integer", "description": "Optional. The duration of the vacation unlock starting from when the request is processed. (1 day is treated as 24 hours)", "format": "int32" } } }, "FindDevicesByOwnerResponse": { "type": "object", "properties": { "nextPageToken": { "description": "A token used to access the next page of results. Omitted if no further results are available.", "type": "string" }, "devices": { "description": "The customer's devices.", "items": { "$ref": "Device" }, "type": "array" }, "totalSize": { "type": "integer", "description": "The total count of items in the list irrespective of pagination.", "format": "int32" } }, "id": "FindDevicesByOwnerResponse", "description": "Response containing found devices." }, "CustomerUnclaimDeviceRequest": { "type": "object", "properties": { "device": { "description": "Required. The device to unclaim. There are custom validations in UnclaimDeviceRequestValidator.", "$ref": "DeviceReference" } }, "id": "CustomerUnclaimDeviceRequest", "description": "Request message for customer to unclaim a device." }, "DeviceReference": { "type": "object", "properties": { "deviceId": { "description": "The ID of the device.", "format": "int64", "type": "string" }, "deviceIdentifier": { "description": "The hardware IDs of the device.", "$ref": "DeviceIdentifier" } }, "id": "DeviceReference", "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)." }, "ListVendorCustomersResponse": { "type": "object", "properties": { "totalSize": { "description": "The total count of items in the list irrespective of pagination.", "format": "int32", "type": "integer" }, "nextPageToken": { "description": "A token to retrieve the next page of results. Omitted if no further results are available.", "type": "string" }, "customers": { "description": "List of customers of the vendor.", "items": { "$ref": "Company" }, "type": "array" } }, "id": "ListVendorCustomersResponse", "description": "Response message to list customers of the vendor." } }, "version_module": true, "batchPath": "batch", "version": "v1", "ownerDomain": "google.com", "resources": { "operations": { "methods": { "get": { "httpMethod": "GET", "path": "v1/{+name}", "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.", "response": { "$ref": "Operation" }, "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "required": true, "type": "string", "pattern": "^operations/.*$" } }, "parameterOrder": [ "name" ], "id": "androiddeviceprovisioning.operations.get", "flatPath": "v1/operations/{operationsId}" } } }, "partners": { "resources": { "vendors": { "methods": { "list": { "path": "v1/{+parent}/vendors", "httpMethod": "GET", "response": { "$ref": "ListVendorsResponse" }, "description": "Lists the vendors of the partner.", "parameters": { "parent": { "pattern": "^partners/[^/]+$", "required": true, "type": "string", "description": "Required. The resource name in the format `partners/[PARTNER_ID]`.", "location": "path" }, "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", "id": "androiddeviceprovisioning.partners.vendors.list" } }, "resources": { "customers": { "methods": { "list": { "flatPath": "v1/partners/{partnersId}/vendors/{vendorsId}/customers", "id": "androiddeviceprovisioning.partners.vendors.customers.list", "parameters": { "pageSize": { "type": "integer", "description": "The maximum number of results to be returned.", "location": "query", "format": "int32" }, "pageToken": { "description": "A token identifying a page of results returned by the server.", "location": "query", "type": "string" }, "parent": { "required": true, "type": "string", "pattern": "^partners/[^/]+/vendors/[^/]+$", "description": "Required. The resource name in the format `partners/[PARTNER_ID]/vendors/[VENDOR_ID]`.", "location": "path" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListVendorCustomersResponse" }, "description": "Lists the customers of the vendor.", "path": "v1/{+parent}/customers", "httpMethod": "GET" } } } } }, "devices": { "methods": { "claimAsync": { "httpMethod": "POST", "flatPath": "v1/partners/{partnersId}/devices:claimAsync", "request": { "$ref": "ClaimDevicesRequest" }, "id": "androiddeviceprovisioning.partners.devices.claimAsync", "parameterOrder": [ "partnerId" ], "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).", "path": "v1/partners/{+partnerId}/devices:claimAsync", "parameters": { "partnerId": { "pattern": "^[^/]+$", "required": true, "type": "string", "format": "int64", "description": "Required. The ID of the reseller partner.", "location": "path" } } }, "claim": { "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.", "response": { "$ref": "ClaimDeviceResponse" }, "path": "v1/partners/{+partnerId}/devices:claim", "parameters": { "partnerId": { "pattern": "^[^/]+$", "required": true, "type": "string", "format": "int64", "description": "Required. The ID of the reseller partner.", "location": "path" } }, "httpMethod": "POST", "id": "androiddeviceprovisioning.partners.devices.claim", "flatPath": "v1/partners/{partnersId}/devices:claim", "request": { "$ref": "ClaimDeviceRequest" }, "parameterOrder": [ "partnerId" ] }, "findByOwner": { "httpMethod": "POST", "flatPath": "v1/partners/{partnersId}/devices:findByOwner", "request": { "$ref": "FindDevicesByOwnerRequest" }, "id": "androiddeviceprovisioning.partners.devices.findByOwner", "parameterOrder": [ "partnerId" ], "response": { "$ref": "FindDevicesByOwnerResponse" }, "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", "parameters": { "partnerId": { "pattern": "^[^/]+$", "required": true, "type": "string", "format": "int64", "description": "Required. The ID of the reseller partner.", "location": "path" } } }, "unclaim": { "flatPath": "v1/partners/{partnersId}/devices:unclaim", "request": { "$ref": "UnclaimDeviceRequest" }, "id": "androiddeviceprovisioning.partners.devices.unclaim", "parameterOrder": [ "partnerId" ], "httpMethod": "POST", "parameters": { "partnerId": { "description": "Required. The ID of the reseller partner.", "location": "path", "format": "int64", "required": true, "type": "string", "pattern": "^[^/]+$" } }, "response": { "$ref": "Empty" }, "description": "Unclaims a device from a customer and removes it from zero-touch enrollment.", "path": "v1/partners/{+partnerId}/devices:unclaim" }, "getSimLockState": { "parameterOrder": [ "partnerId" ], "id": "androiddeviceprovisioning.partners.devices.getSimLockState", "flatPath": "v1/partners/{partnersId}/devices:getSimLockState", "request": { "$ref": "GetDeviceSimLockStateRequest" }, "httpMethod": "POST", "parameters": { "partnerId": { "description": "Required. The ID of the partner.", "location": "path", "format": "int64", "required": true, "type": "string", "pattern": "^[^/]+$" } }, "path": "v1/partners/{+partnerId}/devices:getSimLockState", "description": "Gets a device's SIM lock state.", "response": { "$ref": "GetDeviceSimLockStateResponse" } }, "get": { "parameters": { "name": { "pattern": "^partners/[^/]+/devices/[^/]+$", "required": true, "type": "string", "description": "Required. The device API resource name in the format `partners/[PARTNER_ID]/devices/[DEVICE_ID]`.", "location": "path" } }, "parameterOrder": [ "name" ], "id": "androiddeviceprovisioning.partners.devices.get", "flatPath": "v1/partners/{partnersId}/devices/{devicesId}", "httpMethod": "GET", "path": "v1/{+name}", "description": "Gets a device.", "response": { "$ref": "Device" } }, "updateMetadataAsync": { "parameterOrder": [ "partnerId" ], "flatPath": "v1/partners/{partnersId}/devices:updateMetadataAsync", "request": { "$ref": "UpdateDeviceMetadataInBatchRequest" }, "id": "androiddeviceprovisioning.partners.devices.updateMetadataAsync", "httpMethod": "POST", "parameters": { "partnerId": { "format": "int64", "description": "Required. The reseller partner ID.", "location": "path", "pattern": "^[^/]+$", "required": true, "type": "string" } }, "path": "v1/partners/{+partnerId}/devices:updateMetadataAsync", "response": { "$ref": "Operation" }, "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." }, "findByIdentifier": { "parameterOrder": [ "partnerId" ], "flatPath": "v1/partners/{partnersId}/devices:findByIdentifier", "request": { "$ref": "FindDevicesByDeviceIdentifierRequest" }, "id": "androiddeviceprovisioning.partners.devices.findByIdentifier", "httpMethod": "POST", "parameters": { "partnerId": { "format": "int64", "description": "Required. The ID of the reseller partner.", "location": "path", "pattern": "^[^/]+$", "required": true, "type": "string" } }, "path": "v1/partners/{+partnerId}/devices:findByIdentifier", "response": { "$ref": "FindDevicesByDeviceIdentifierResponse" }, "description": "Finds devices by hardware identifiers, such as IMEI." }, "metadata": { "path": "v1/partners/{+metadataOwnerId}/devices/{+deviceId}/metadata", "description": "Updates reseller metadata associated with the device. Android devices only.", "response": { "$ref": "DeviceMetadata" }, "parameters": { "deviceId": { "required": true, "type": "string", "pattern": "^[^/]+$", "description": "Required. The ID of the device.", "location": "path", "format": "int64" }, "metadataOwnerId": { "pattern": "^[^/]+$", "required": true, "type": "string", "format": "int64", "description": "Required. The owner of the newly set metadata. Set this to the partner ID.", "location": "path" } }, "httpMethod": "POST", "parameterOrder": [ "metadataOwnerId", "deviceId" ], "id": "androiddeviceprovisioning.partners.devices.metadata", "flatPath": "v1/partners/{partnersId}/devices/{devicesId}/metadata", "request": { "$ref": "UpdateDeviceMetadataRequest" } }, "unclaimAsync": { "path": "v1/partners/{+partnerId}/devices:unclaimAsync", "response": { "$ref": "Operation" }, "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).", "parameters": { "partnerId": { "description": "Required. The reseller partner ID.", "location": "path", "format": "int64", "required": true, "type": "string", "pattern": "^[^/]+$" } }, "httpMethod": "POST", "parameterOrder": [ "partnerId" ], "flatPath": "v1/partners/{partnersId}/devices:unclaimAsync", "request": { "$ref": "UnclaimDevicesRequest" }, "id": "androiddeviceprovisioning.partners.devices.unclaimAsync" } } }, "customers": { "methods": { "list": { "id": "androiddeviceprovisioning.partners.customers.list", "flatPath": "v1/partners/{partnersId}/customers", "parameters": { "pageSize": { "format": "int32", "description": "The maximum number of results to be returned. If not specified or 0, all the records are returned.", "location": "query", "type": "integer" }, "pageToken": { "description": "A token identifying a page of results returned by the server.", "location": "query", "type": "string" }, "partnerId": { "description": "Required. The ID of the reseller partner.", "location": "path", "format": "int64", "required": true, "type": "string", "pattern": "^[^/]+$" } }, "parameterOrder": [ "partnerId" ], "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.", "response": { "$ref": "ListCustomersResponse" }, "httpMethod": "GET", "path": "v1/partners/{+partnerId}/customers" }, "create": { "path": "v1/{+parent}/customers", "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.", "response": { "$ref": "Company" }, "parameters": { "parent": { "pattern": "^partners/[^/]+$", "required": true, "type": "string", "description": "Required. The parent resource ID in the format `partners/[PARTNER_ID]` that identifies the reseller.", "location": "path" } }, "httpMethod": "POST", "parameterOrder": [ "parent" ], "id": "androiddeviceprovisioning.partners.customers.create", "flatPath": "v1/partners/{partnersId}/customers", "request": { "$ref": "CreateCustomerRequest" } } } } } }, "customers": { "methods": { "list": { "parameters": { "pageSize": { "description": "Required. The maximum number of customers to show in a page of results. A number between 1 and 100 (inclusive).", "location": "query", "format": "int32", "type": "integer" }, "pageToken": { "description": "A token specifying which result page to return. This field has custom validations in ListCustomersRequestValidator", "location": "query", "type": "string" } }, "parameterOrder": [], "id": "androiddeviceprovisioning.customers.list", "flatPath": "v1/customers", "httpMethod": "GET", "path": "v1/customers", "description": "Lists the user's customer accounts.", "response": { "$ref": "CustomerListCustomersResponse" } } }, "resources": { "devices": { "methods": { "applyConfiguration": { "parameterOrder": [ "parent" ], "flatPath": "v1/customers/{customersId}/devices:applyConfiguration", "request": { "$ref": "CustomerApplyConfigurationRequest" }, "id": "androiddeviceprovisioning.customers.devices.applyConfiguration", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "required": true, "type": "string", "description": "Required. The customer managing the device. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path" } }, "path": "v1/{+parent}/devices:applyConfiguration", "response": { "$ref": "Empty" }, "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." }, "get": { "response": { "$ref": "Device" }, "description": "Gets the details of a device.", "path": "v1/{+name}", "httpMethod": "GET", "flatPath": "v1/customers/{customersId}/devices/{devicesId}", "id": "androiddeviceprovisioning.customers.devices.get", "parameters": { "name": { "description": "Required. The device to get. An API resource name in the format `customers/[CUSTOMER_ID]/devices/[DEVICE_ID]`.", "location": "path", "required": true, "type": "string", "pattern": "^customers/[^/]+/devices/[^/]+$" } }, "parameterOrder": [ "name" ] }, "removeConfiguration": { "parameters": { "parent": { "description": "Required. The customer managing the device in the format `customers/[CUSTOMER_ID]`.", "location": "path", "required": true, "type": "string", "pattern": "^customers/[^/]+$" } }, "path": "v1/{+parent}/devices:removeConfiguration", "description": "Removes a configuration from device.", "response": { "$ref": "Empty" }, "parameterOrder": [ "parent" ], "id": "androiddeviceprovisioning.customers.devices.removeConfiguration", "flatPath": "v1/customers/{customersId}/devices:removeConfiguration", "request": { "$ref": "CustomerRemoveConfigurationRequest" }, "httpMethod": "POST" }, "list": { "response": { "$ref": "CustomerListDevicesResponse" }, "description": "Lists a customer's devices.", "path": "v1/{+parent}/devices", "httpMethod": "GET", "flatPath": "v1/customers/{customersId}/devices", "id": "androiddeviceprovisioning.customers.devices.list", "parameters": { "parent": { "description": "Required. The customer managing the devices. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path", "required": true, "type": "string", "pattern": "^customers/[^/]+$" }, "pageSize": { "description": "Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive.", "location": "query", "format": "int64", "type": "string" }, "pageToken": { "type": "string", "description": "A token specifying which result page to return.", "location": "query" } }, "parameterOrder": [ "parent" ] }, "unclaim": { "response": { "$ref": "Empty" }, "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.", "path": "v1/{+parent}/devices:unclaim", "parameters": { "parent": { "required": true, "type": "string", "pattern": "^customers/[^/]+$", "description": "Required. The customer managing the device. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path" } }, "httpMethod": "POST", "flatPath": "v1/customers/{customersId}/devices:unclaim", "request": { "$ref": "CustomerUnclaimDeviceRequest" }, "id": "androiddeviceprovisioning.customers.devices.unclaim", "parameterOrder": [ "parent" ] } } }, "configurations": { "methods": { "list": { "response": { "$ref": "CustomerListConfigurationsResponse" }, "description": "Lists a customer's configurations.", "path": "v1/{+parent}/configurations", "httpMethod": "GET", "flatPath": "v1/customers/{customersId}/configurations", "id": "androiddeviceprovisioning.customers.configurations.list", "parameters": { "parent": { "description": "Required. The customer that manages the listed configurations. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path", "required": true, "type": "string", "pattern": "^customers/[^/]+$" } }, "parameterOrder": [ "parent" ] }, "patch": { "parameterOrder": [ "name" ], "flatPath": "v1/customers/{customersId}/configurations/{configurationsId}", "request": { "$ref": "Configuration" }, "id": "androiddeviceprovisioning.customers.configurations.patch", "httpMethod": "PATCH", "parameters": { "name": { "pattern": "^customers/[^/]+/configurations/[^/]+$", "required": true, "type": "string", "description": "Output only. The API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by the server.", "location": "path" }, "updateMask": { "type": "string", "format": "google-fieldmask", "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" } }, "path": "v1/{+name}", "response": { "$ref": "Configuration" }, "description": "Updates a configuration's field values." }, "create": { "parameters": { "parent": { "required": true, "type": "string", "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" } }, "path": "v1/{+parent}/configurations", "description": "Creates a new configuration. Once created, a customer can apply the configuration to devices.", "response": { "$ref": "Configuration" }, "parameterOrder": [ "parent" ], "id": "androiddeviceprovisioning.customers.configurations.create", "flatPath": "v1/customers/{customersId}/configurations", "request": { "$ref": "Configuration" }, "httpMethod": "POST" }, "get": { "path": "v1/{+name}", "httpMethod": "GET", "response": { "$ref": "Configuration" }, "description": "Gets the details of a configuration.", "parameters": { "name": { "required": true, "type": "string", "pattern": "^customers/[^/]+/configurations/[^/]+$", "description": "Required. The configuration to get. An API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`.", "location": "path" } }, "parameterOrder": [ "name" ], "flatPath": "v1/customers/{customersId}/configurations/{configurationsId}", "id": "androiddeviceprovisioning.customers.configurations.get" }, "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "response": { "$ref": "Empty" }, "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/[^/]+$", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "flatPath": "v1/customers/{customersId}/configurations/{configurationsId}", "id": "androiddeviceprovisioning.customers.configurations.delete" } } }, "dpcs": { "methods": { "list": { "id": "androiddeviceprovisioning.customers.dpcs.list", "flatPath": "v1/customers/{customersId}/dpcs", "parameters": { "parent": { "description": "Required. The customer that can use the DPCs in configurations. An API resource name in the format `customers/[CUSTOMER_ID]`.", "location": "path", "pattern": "^customers/[^/]+$", "required": true, "type": "string" } }, "parameterOrder": [ "parent" ], "description": "Lists the DPCs (device policy controllers) that support zero-touch enrollment.", "response": { "$ref": "CustomerListDpcsResponse" }, "httpMethod": "GET", "path": "v1/{+parent}/dpcs" } } } } } }, "fullyEncodeReservedExpansion": true, "description": "Automates Android zero-touch enrollment for device resellers, customers, and EMMs.", "rootUrl": "https://androiddeviceprovisioning.googleapis.com/", "baseUrl": "https://androiddeviceprovisioning.googleapis.com/", "name": "androiddeviceprovisioning", "discoveryVersion": "v1", "revision": "20260421", "basePath": "", "documentationLink": "https://developers.google.com/zero-touch/", "parameters": { "prettyPrint": { "type": "boolean", "default": "true", "description": "Returns response with indentations and line breaks.", "location": "query" }, "$.xgafv": { "type": "string", "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ], "description": "V1 error format.", "location": "query" }, "fields": { "description": "Selector specifying which fields to include in a partial response.", "location": "query", "type": "string" }, "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" }, "access_token": { "description": "OAuth access token.", "location": "query", "type": "string" }, "callback": { "description": "JSONP", "location": "query", "type": "string" }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query", "type": "string" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "alt": { "default": "json", "enum": [ "json", "media", "proto" ], "description": "Data format for response.", "location": "query", "type": "string", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ] }, "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" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" } }, "ownerName": "Google" }