Method: customers.userListQueries.patch

AI-generated Key Takeaways

• This page details how to update an existing user list query using a PATCH HTTP request.

• Partial updates to user list queries are supported.

• The request uses a specific URL format that includes the query name, which acts as a unique identifier.

• The request body requires an instance of the UserListQuery resource and supports a field mask for partial updates.

• Successful updates will return an instance of the UserListQuery resource in the response body and require a specific OAuth scope for authorization.

• HTTP request
• Path parameters
• Query parameters
• Request body
• Response body
• Authorization scopes

Updates an existing user list query. Partial updates are supported. Please review the UserListQuery resource to see which fields can be updated.

HTTP request

PATCH https://adsdatahub.googleapis.com/v1/{query.name=customers/*/userListQueries/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
query.name	string Output only. Immutable. Name that uniquely identifies a query. It has the form customers/[customerId]/userListQueries/[resource_id], e.g. 'customers/123/userListQueries/abcd1234'. The resource ID is generated by the server.

Query parameters

Parameters
updateMask	string (FieldMask format) Field mask used to support partial updates. 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 UserListQuery.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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