Method: deployments.configs.update

  • This documentation outlines how to update a device configuration using the Android Over-the-Air (OTA) service via a PUT request.

  • You can specify the target configuration using a structured path parameter in the request URL.

  • The request body requires a JSON payload containing the updated configuration data and a version tag for concurrency control.

  • Successful requests will return the updated configuration, and you will need the android_partner_over_the_air OAuth scope for authorization.

Updates a config. Returns INVALID_ARGUMENT if the name of the config is non-empty and does not equal the existing name.

HTTP request

PUT https://androidovertheair.googleapis.com/v1/{name=deployments/*/configs/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Relative resource name. For example: "deployments/deployment_x/configs/config_a"

Request body

The request body contains data with the following structure:

JSON representation
{
  "config": {
    object (Config)
  },
  "versionTag": {
    object (VersionTag)
  }
}
Fields
config

object (Config)

The Config to update.

versionTag

object (VersionTag)

Required. The config to be updated should match this version. If another client updates the existing config concurrently, the update operation will fail.

Response body

If successful, the response body contains an instance of Config.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/android_partner_over_the_air

For more information, see the OAuth 2.0 Overview.