The Display & Video 360 API lets you disclose assets as AI-generated or AI-edited. Labels will be applied to ads with such assets at serving in regions with local AI labeling regulations. As of today, those regions are the European Union (EU), India, and New York state.
Learn more in the Display & Video 360 Help Center.
Support in the Display & Video 360 API
The Display & Video 360 API includes an optional field,
syntheticContentAttestationStatus, in the
Creative and
AdAsset resources. This field lets you specify
whether a creative or asset contains content that was created or edited with AI.
Setting syntheticContentAttestationStatus to IS_SYNTHETIC applies the label
in regions with local AI labeling regulations, while setting it to
NOT_SYNTHETIC confirms that the content does not require a label. You can also
leave the field unset. A label won't be applied if the field is left unset.
However, after the field is set for a resource, it can't be unset and may only
be updated to be either IS_SYNTHETIC or NOT_SYNTHETIC.
Valid values of the
SyntheticContentAttestationStatus enum are shown
in the following table:
SyntheticContentAttestationStatus Enum values | |
|---|---|
SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED |
No attestation has been provided. |
NOT_SYNTHETIC |
Attested as not created or edited with AI. |
IS_SYNTHETIC |
Attested as created or edited with AI. |
For more information on how setting this field affects ad serving, refer to the Display & Video 360 Help Center.
Label real-time bidding creatives
In Display & Video 360 API, the ad creatives served by real-time bidding ads are defined by
Creative resources. Label real-time bidding creatives using
the syntheticContentAttestationStatus field
in a Creative resource.
New creatives
Set this field when creating new creatives using
advertisers.creatives.create.
Existing creatives
To update existing creatives:
- Retrieve your existing creatives using
advertisers.creatives.list. - Check their existing
syntheticContentAttestationStatusfield value. - If needed, use
advertisers.creatives.patchto update the field for any existing creatives.
Label YouTube and Demand Gen ad assets
In Display & Video 360 API, the ad creatives served by YouTube and Demand Gen ads are made
up of individual AdAsset resources. Label YouTube video or
image assets used in YouTube and Demand Gen ads using
syntheticContentAttestationStatus field in an
AdAsset resource.
New assets
Set this field when creating new assets:
- For a new YouTube video asset, in the
AdAssetobject of anadvertisers.adAssets.createrequest. - For an image asset, In the request body of
advertisers.adAssets.uploadrequest.
Assets for the same YouTube video must have the same
syntheticContentAttestationStatus field value,
if set. Use advertisers.adAssets.list with the following
filter parameter to see if an asset for the relevant YouTube video ID already
exists before attempting to create a new one:
youtubeVideoAsset.youtubeVideoId=youtube-video-id
Existing assets
To update existing assets:
- Retrieve your existing creatives using
advertisers.adAssets.list. - Check their existing
syntheticContentAttestationStatusfield value. - If needed, use
advertisers.adAssets.patchto update the field for any existing ad assets.