REST Resource: targetableRemarketingLists
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-16 UTC.
[null,null,["Last updated 2024-10-16 UTC."],[[["\u003cp\u003eTargetable remarketing lists help target ads to users based on their website actions, and this resource provides read-only access to those lists.\u003c/p\u003e\n"],["\u003cp\u003eYou can access both advertiser-owned and shared remarketing lists using this resource but manage advertiser-owned lists via the RemarketingLists resource.\u003c/p\u003e\n"],["\u003cp\u003eThis resource includes properties like list ID, name, description, size, lifespan, and source, allowing you to understand and utilize the list for targeting.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation and detailed field descriptions offer a comprehensive view of the data structure and properties associated with a TargetableRemarketingList object.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve individual lists using the \u003ccode\u003eget\u003c/code\u003e method or a filtered list using the \u003ccode\u003elist\u003c/code\u003e method, enabling efficient data retrieval for specific needs.\u003c/p\u003e\n"]]],[],null,["# REST Resource: targetableRemarketingLists\n\n- [Resource: TargetableRemarketingList](#TargetableRemarketingList)\n - [JSON representation](#TargetableRemarketingList.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: TargetableRemarketingList\n-----------------------------------\n\nContains properties of a [targetable remarketing list](https://support.google.com/dcm/topic/6094293). Remarketing enables you to create lists of users who have performed specific actions on a site, then target ads to members of those lists. This resource is a read-only view of a remarketing list to be used to facilitate targeting ads to specific lists. Remarketing lists that are owned by your advertisers and those that are shared to your advertisers or account are accessible via this resource. To manage remarketing lists that are owned by your advertisers, use the [RemarketingLists](/doubleclick-advertisers/rest/v4/remarketingLists) resource.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"accountId\": string, \"subaccountId\": string, \"advertiserId\": string, \"advertiserIdDimensionValue\": { object (/doubleclick-advertisers/rest/v4/DimensionValue) }, \"name\": string, \"description\": string, \"active\": boolean, \"listSize\": string, \"lifeSpan\": string, \"listSource\": enum (/doubleclick-advertisers/rest/v4/RemarketingListSource), \"kind\": string } ``` |\n\n| Fields ||\n|------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Targetable remarketing list ID. |\n| `account``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Account ID of this remarketing list. This is a read-only, auto-generated field that is only returned in `GET` requests. |\n| `subaccount``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Subaccount ID of this remarketing list. This is a read-only, auto-generated field that is only returned in `GET` requests. |\n| `advertiser``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Dimension value for the advertiser ID that owns this targetable remarketing list. |\n| `advertiser``Id``Dimension``Value` | `object (`[DimensionValue](/doubleclick-advertisers/rest/v4/DimensionValue)`)` Dimension value for the ID of the advertiser. |\n| `name` | `string` Name of the targetable remarketing list. Is no greater than 128 characters long. |\n| `description` | `string` Targetable remarketing list description. |\n| `active` | `boolean` Whether this targetable remarketing list is active. |\n| `list``Size` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of users currently in the list. This is a read-only field. |\n| `life``Span` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of days that a user should remain in the targetable remarketing list without an impression. |\n| `list``Source` | `enum (`[RemarketingListSource](/doubleclick-advertisers/rest/v4/RemarketingListSource)`)` Product from which this targetable remarketing list was originated. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#targetableRemarketingList\"` . |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------|----------------------------------------------------------------------|\n| ### [get](/doubleclick-advertisers/rest/v4/targetableRemarketingLists/get) | Gets one remarketing list by ID. |\n| ### [list](/doubleclick-advertisers/rest/v4/targetableRemarketingLists/list) | Retrieves a list of targetable remarketing lists, possibly filtered. |"]]