Starting
September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our
deprecations page for more details on how to update your integration to make this declaration.
REST Resource: floodlightGroups.floodlightActivities
Stay organized with collections
Save and categorize content based on your preferences.
Resource: FloodlightActivity
A single Floodlight activity.
| JSON representation |
{
"name": string,
"floodlightGroupId": string,
"floodlightActivityId": string,
"displayName": string,
"servingStatus": enum (FloodlightActivityServingStatus),
"advertiserIds": [
string
],
"remarketingConfigs": [
{
object (RemarketingConfig)
}
],
"sslRequired": boolean
} |
| Fields |
name |
string
Output only. The resource name of the Floodlight activity.
|
floodlightGroupId |
string (int64 format)
Required. Immutable. The ID of the parent Floodlight group.
|
floodlightActivityId |
string (int64 format)
Output only. The unique ID of the Floodlight activity. Assigned by the system.
|
displayName |
string
Required. The display name of the Floodlight activity.
|
servingStatus |
enum (FloodlightActivityServingStatus)
Optional. Whether the Floodlight activity is served.
|
advertiserIds[] |
string (int64 format)
Output only. IDs of the advertisers that have access to the parent Floodlight group. Only advertisers under the provided partner ID will be listed in this field.
|
sslRequired |
boolean
Output only. Whether tags are required to be compliant.
|
FloodlightActivityServingStatus
Possible serving statuses of a Floodlight activity.
| Enums |
FLOODLIGHT_ACTIVITY_SERVING_STATUS_UNSPECIFIED |
Type value is not specified or is unknown in this version. |
FLOODLIGHT_ACTIVITY_SERVING_STATUS_ENABLED |
Enabled. |
FLOODLIGHT_ACTIVITY_SERVING_STATUS_DISABLED |
Disabled. |
Methods |
|
|
Gets a Floodlight activity. |
|
|
Lists Floodlight activities in a Floodlight group. |
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 2025-03-27 UTC.
[null,null,["Last updated 2025-03-27 UTC."],[],["The Display & Video 360 API v4, currently in beta, includes resources for managing Floodlight activities. Key information includes the `FloodlightActivity` resource, which represents a single Floodlight activity with properties like `name`, `floodlightGroupId`, `displayName`, and `servingStatus`. Remarketing configurations (`RemarketingConfig`) can also be set, enabling or disabling remarketing for specific advertisers. Possible serving statuses are `ENABLED` and `DISABLED`. Available methods include getting and listing Floodlight activities.\n"],null,["# REST Resource: floodlightGroups.floodlightActivities\n\n- [Resource: FloodlightActivity](#FloodlightActivity)\n - [JSON representation](#FloodlightActivity.SCHEMA_REPRESENTATION)\n- [FloodlightActivityServingStatus](#FloodlightActivityServingStatus)\n- [RemarketingConfig](#RemarketingConfig)\n - [JSON representation](#RemarketingConfig.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: FloodlightActivity\n----------------------------\n\nA single Floodlight activity.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"floodlightGroupId\": string, \"floodlightActivityId\": string, \"displayName\": string, \"servingStatus\": enum (/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities#FloodlightActivityServingStatus), \"advertiserIds\": [ string ], \"remarketingConfigs\": [ { object (/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities#RemarketingConfig) } ], \"sslRequired\": boolean } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the Floodlight activity. |\n| `floodlightGroupId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. Immutable. The ID of the parent Floodlight group. |\n| `floodlightActivityId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the Floodlight activity. Assigned by the system. |\n| `displayName` | `string` Required. The display name of the Floodlight activity. |\n| `servingStatus` | `enum (`[FloodlightActivityServingStatus](/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities#FloodlightActivityServingStatus)`)` Optional. Whether the Floodlight activity is served. |\n| `advertiserIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. IDs of the advertisers that have access to the parent Floodlight group. Only advertisers under the provided partner ID will be listed in this field. |\n| `remarketingConfigs[]` | `object (`[RemarketingConfig](/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities#RemarketingConfig)`)` Output only. A list of configuration objects designating whether remarketing for this Floodlight Activity is enabled and available for a specifc advertiser. If enabled, this Floodlight Activity generates a remarketing user list that is able to be used in targeting under the advertiser. |\n| `sslRequired` | `boolean` Output only. Whether tags are required to be compliant. |\n\nFloodlightActivityServingStatus\n-------------------------------\n\nPossible serving statuses of a Floodlight activity.\n\n| Enums ||\n|--------------------------------------------------|------------------------------------------------------------|\n| `FLOODLIGHT_ACTIVITY_SERVING_STATUS_UNSPECIFIED` | Type value is not specified or is unknown in this version. |\n| `FLOODLIGHT_ACTIVITY_SERVING_STATUS_ENABLED` | Enabled. |\n| `FLOODLIGHT_ACTIVITY_SERVING_STATUS_DISABLED` | Disabled. |\n\nRemarketingConfig\n-----------------\n\nSettings that control the whether remarketing is enabled for the given identified advertiser.\n\n| JSON representation |\n|-------------------------------------------------------------------|\n| ``` { \"advertiserId\": string, \"remarketingEnabled\": boolean } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The ID of the advertiser. |\n| `remarketingEnabled` | `boolean` Output only. Whether the Floodlight activity remarketing user list is available to the identified advertiser. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------|----------------------------------------------------|\n| ### [get](/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities/get) | Gets a Floodlight activity. |\n| ### [list](/display-video/api/reference/rest/v4/floodlightGroups.floodlightActivities/list) | Lists Floodlight activities in a Floodlight group. |"]]
