Method: customers.userLists.patch

  • This page provides details for updating an Ads Data Hub-managed user list using a PATCH request.

  • The HTTP request uses a specific URL structure with path parameters for identifying the user list.

  • Query parameters include updateMask which is required for partial updates and specifies which fields can be modified.

  • The request and response bodies both contain an instance of the UserList object.

  • Updating the user list requires the https://www.googleapis.com/auth/adsdatahub OAuth scope.

Updates the requested Ads Data Hub-managed user list.

HTTP request

PATCH https://adsdatahub.googleapis.com/v1/{userList.name=customers/*/userLists/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
userList.name

string

Output only. Immutable. Name that uniquely identifies an Ads Data Hub user list. It has the form customers/[customerId]/userLists/[userListId]

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. Field mask to support partial updates. Only the following paths may be updated via the API: - title - description - recipientAdsDataLinks

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 UserList.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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