Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.

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.