Learn more about migrating to the Google Ads API by watching our latest webinar

UserListService

Service to manage user lists.

GetUserList

rpc GetUserList(GetUserListRequest) returns (UserList)

Returns the requested user list.

List of thrown errors: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

MutateUserLists

rpc MutateUserLists(MutateUserListsRequest) returns (MutateUserListsResponse)

Creates or updates user lists. Operation statuses are returned.

List of thrown errors: AuthenticationError AuthorizationError CollectionSizeError DatabaseError DistinctError FieldError FieldMaskError HeaderError InternalError MutateError NewResourceCreationError NotAllowlistedError NotEmptyError OperationAccessDeniedError QuotaError RangeError RequestError StringFormatError StringLengthError UserListError

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.