Method: sellers.adUnits.patch

Updates an existing ad unit.

  • Returns the updated ad unit if successful.
  • Returns error code NOT_FOUND if the ad unit does not exist.
  • Returns error code INVALID_ARGUMENT if an immutable field is specified in updateMask and a change is requested.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The resource name of the ad unit in the format: sellers/{seller}/adUnits/{adUnit}. For example sellers/seller321/adUnits/adUnit123.

Query parameters


string (FieldMask format)

Required. The mask to control which fields to update.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body contains an instance of AdUnit.

Response body

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

Authorization Scopes

Requires the following OAuth scope:


For more information, see the OAuth 2.0 Overview.