Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13285997.9 KB
buyers

Creates a new user list.

post/v1/{+parent}/userLists

Path parameters

parentstring required

Required. The name of the parent buyer of the user list to be retrieved, which must follow the pattern buyers/{buyerAccountId}, where {buyerAccountId} represents the account ID of the buyer who owns the user list. For a bidder accessing user lists on behalf of a child seat buyer, {buyerAccountId} should represent the account ID of the child seat buyer.

Request body

namestring

Output only. Name of the user list that must follow the pattern buyers/{buyer}/userLists/{user_list}, where {buyer} represents the account ID of the buyer who owns the user list. For a bidder accessing user lists on behalf of a child seat buyer, {buyer} represents the account ID of the child seat buyer. {user_list} is an int64 identifier assigned by Google to uniquely identify a user list.

status'STATUS_UNSPECIFIED' | 'OPEN' | 'CLOSED'

Output only. The status of the user list. A new user list starts out as open.

displayNamestring

Required. Display name of the user list. This must be unique across all user lists for a given account.

descriptionstring

The description for the user list.

membershipDurationDaysstring int64

Required. The number of days a user's cookie stays on the user list. The field must be between 0 and 540 inclusive.

Response

Successful response