UserList

A user list. This is a list of users a customer may target.

Fields
resource_name	string Immutable. The resource name of the user list. User list resource names have the form: customers/{customer_id}/userLists/{user_list_id}
id	Int64Value Output only. Id of the user list.
read_only	BoolValue Output only. A flag that indicates if a user may edit a list. Depends on the list ownership and list type. For example, external remarketing user lists are not editable. This field is read-only.
name	StringValue Name of this user list. Depending on its access_reason, the user list name may not be unique (e.g. if access_reason=SHARED)
description	StringValue Description of this user list.
membership_status	UserListMembershipStatus Membership status of this user list. Indicates whether a user list is open or active. Only open user lists can accumulate more users and can be targeted to.
integration_code	StringValue An ID from external system. It is used by user list sellers to correlate IDs on their systems.
membership_life_span	Int64Value Number of days a user's cookie stays on your list since its most recent addition to the list. This field must be between 0 and 540 inclusive. However, for CRM based userlists, this field can be set to 10000 which means no expiration. It'll be ignored for logical_user_list.
size_for_display	Int64Value Output only. Estimated number of users in this user list, on the Google Display Network. This value is null if the number of users has not yet been determined. This field is read-only.
size_range_for_display	UserListSizeRange Output only. Size range in terms of number of users of the UserList, on the Google Display Network. This field is read-only.
size_for_search	Int64Value Output only. Estimated number of users in this user list in the google.com domain. These are the users available for targeting in Search campaigns. This value is null if the number of users has not yet been determined. This field is read-only.
size_range_for_search	UserListSizeRange Output only. Size range in terms of number of users of the UserList, for Search ads. This field is read-only.
type	UserListType Output only. Type of this list. This field is read-only.
closing_reason	UserListClosingReason Indicating the reason why this user list membership status is closed. It is only populated on lists that were automatically closed due to inactivity, and will be cleared once the list membership status becomes open.
access_reason	AccessReason Output only. Indicates the reason this account has been granted access to the list. The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. This field is read-only.
account_user_list_status	UserListAccessStatus Indicates if this share is still enabled. When a UserList is shared with the user this field is set to ENABLED. Later the userList owner can decide to revoke the share and make it DISABLED. The default value of this field is set to ENABLED.
eligible_for_search	BoolValue Indicates if this user list is eligible for Google Search Network.
eligible_for_display	BoolValue Output only. Indicates this user list is eligible for Google Display Network. This field is read-only.
user_list Union field user_list. The user list. user_list. The user list. Exactly one must be set. user_list can be only one of the following: user_list can be only one of the following:
crm_based_user_list	CrmBasedUserListInfo User list of CRM users provided by the advertiser.
similar_user_list	SimilarUserListInfo Output only. User list which are similar to users from another UserList. These lists are readonly and automatically created by google.
rule_based_user_list	RuleBasedUserListInfo User list generated by a rule.
logical_user_list	LogicalUserListInfo User list that is a custom combination of user lists and user interests.
basic_user_list	BasicUserListInfo User list targeting as a collection of conversion or remarketing actions.