REST Resource: advertisers.creatives

资源：广告素材

单个广告素材。

JSON 表示法 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean
}
字段
name

string

仅供输出。广告素材的资源名称。
advertiserId

string (int64 format)

仅供输出。广告素材所属广告客户的唯一 ID。
creativeId

string (int64 format)

仅供输出。广告素材的唯一 ID。由系统分配。
cmPlacementId

string (int64 format)

仅供输出。与广告素材关联的 Campaign Manager 360 展示位置的唯一 ID。此字段仅适用于从 Campaign Manager 同步过来的广告素材。
displayName

string

必需。广告素材的显示名。

必须采用 UTF-8 编码，大小上限为 240 个字节。
entityStatus

enum (EntityStatus)

必需。控制广告素材能否投放。

接受的值包括：

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

仅供输出。广告素材上次由用户或系统更新时的时间戳（例如广告素材审核）。由系统分配。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
createTime

string (Timestamp format)

仅供输出。广告素材创建时的时间戳。由系统分配。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
creativeType

enum (CreativeType)

必需。不可变。广告素材的类型。
hostingSource

enum (HostingSource)

必需。指明广告素材的托管位置。
dynamic

boolean

仅供输出。指明广告素材是否为动态广告素材。
dimensions

object (Dimensions)

必需。广告素材的主要尺寸。适用于所有广告素材类型。当 creativeType 为以下值之一时，widthPixels 和 heightPixels 的值默认为 0：

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

其他维度。当 creativeType 为以下任一项时适用：

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

如果指定此字段，则 widthPixels 和 heightPixels 均为必需，并且必须大于或等于 0。
mediaDuration

string (Duration format)

仅供输出。广告素材的媒体时长。当 creativeType 为以下任一项时适用：

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
creativeAttributes[]

enum (CreativeAttribute)

仅供输出。系统生成的广告素材属性列表。
reviewStatus

object (ReviewStatusInfo)

仅供输出。广告素材审核流程的当前状态。
assets[]

object (AssetAssociation)

必需。与此广告素材相关联的素材资源。
exitEvents[]

object (ExitEvent)

必需。此广告素材的退出事件。退出（也称为点击代码）是广告素材中可供用户点击或点按以打开广告客户着陆页的任何区域。每个广告素材都必须包含至少一个退出。您可通过以下任一方式向广告素材中添加退出事件：

  • 使用 Google Web Designer 的点按区域。
  • 定义一个名为“clickTag”的 JavaScript 变量。
  • 使用启动器 (launcher.exit()) 跟踪富媒体格式的退出事件。
timerEvents[]

object (TimerEvent)

富媒体广告素材的计时器自定义事件。计时器用于跟踪用户查看富媒体广告素材并与广告素材的特定部分进行互动的时间。一个广告素材可以有多个单独计时的计时器事件。对于仅包含图片素材资源的广告素材，请将此字段留空或未设置。
counterEvents[]

object (CounterEvent)

富媒体广告素材的计数器事件。计数器跟踪用户以特定方式（鼠标悬停、鼠标移开、点击、点按、数据加载、键盘输入等）与富媒体广告素材的任何部分进行互动的次数。可在广告素材中捕获的任何事件都可以记录为计数器事件。对于仅包含图片素材资源的广告素材，请将此字段留空或未设置。
appendedTag

string

要附加到广告素材代码的第三方 HTML 跟踪代码。
integrationCode

string

用于将此广告素材关联到外部系统的 ID 信息。必须采用 UTF-8 编码，长度不超过 10,000 个字符。
notes

string

此广告素材的用户备注。必须采用 UTF-8 编码，长度不超过 20,000 个字符。
iasCampaignMonitoring

boolean

指明是否已启用 Integral Ad Science (IAS) 广告系列监控。要为广告素材启用此功能，请确保已将 Advertiser.creative_config.ias_client_id 设置为您的 IAS 客户 ID。
companionCreativeIds[]

string (int64 format)

视频广告素材的随播广告素材的 ID。

您可以分配现有的展示广告素材（包含图片或 HTML5 素材资源），以便在发布商的视频播放器周围投放。系统会在视频播放时在视频播放器周围展示这些随播广告素材，并在视频播完后继续展示。

包含additional dimensions的广告素材不能成为随播广告素材。

只有以下 creativeType 支持此字段：

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

指明用户是否可以选择跳过某个视频广告素材。

只有以下 creativeType 支持此字段：

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

“跳过”按钮出现前的视频播放时长。

如果 skippable 为 true，则此字段为必填字段。

只有以下 creativeType 支持此字段：

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

视频广告的播放时长（用于统计一次观看）。

如果 skippable 为 true，则此字段为必填字段。

只有以下 creativeType 支持此字段：

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

可选。可选的广告素材标识符，由域名注册管理机构提供，在所有平台上都是唯一的。

通用广告 ID 是 VAST 4.0 标准的一部分。您可以在制作广告素材后对其进行修改。

只有以下 creativeType 支持此字段：

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

跟踪来自第三方的网址，以跟踪用户与视频广告素材的互动情况。

只有以下 creativeType 支持此字段：

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

仅供输出。音频/视频转码。

Display & Video 360 会将主素材资源转码为多个使用不同文件格式或具有不同属性（分辨率、音频比特率和视频比特率）的备用版本，各个版本分别适用于特定的视频播放器或带宽。

这些转码不仅使得发布商的系统在每次展示您的视频时有更多方案可供选择，还可确保根据观看者的网络连接和屏幕尺寸投放适当的文件。

只有以下 creativeType 支持此字段：

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

分析服务提供商或第三方广告技术供应商的跟踪网址。

网址必须以 https 开头（无需符合 SSL 规定的广告资源除外）。如果您的网址中使用宏，请仅使用 Display & Video 360 支持的宏。

仅限标准网址，不支持 IMG 或 SCRIPT 代码。

此字段只能在以下 creativeType 中写入：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

来自受支持的第三方验证服务提供商（ComScore、DoubleVerify、IAS、Moat）的 JavaScript 衡量网址。不支持 HTML 脚本代码。

此字段只能在以下 creativeType 中写入：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

与广告素材关联的 Campaign Manager 360 跟踪广告。

如果以下 creativeType 由同时使用 Campaign Manager 360 和第三方广告投放的广告客户创建，则为可选：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

仅在其他情况下输出。
obaIcon

object (ObaIcon)

指定视频广告素材的 OBA 图标。

只有以下 creativeType 支持此字段：

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

可选。用于广告素材的原始第三方代码。

必需且仅对第三方代码广告素材有效。

第三方代码广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

可选。指明广告素材需要 MRAID（移动富媒体广告接口定义系统）。

如果广告素材需要依靠移动手势（例如滑动或点按）进行互动，请设置此项。

可选，仅对第三方代码广告素材有效。

第三方代码广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

可选。表示广告素材依赖 HTML5 才能正常呈现。

可选，仅对第三方代码广告素材有效。第三方代码广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

可选。表示广告素材将等待返回 ping 以进行归因。

仅在使用包含第三方广告服务器参数和 ${DC_DBM_TOKEN} 宏的 Campaign Manager 360 跟踪广告时有效。

可选，仅对第三方代码广告素材或第三方 VAST 代码广告素材有效。

第三方代码广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

第三方 VAST 代码广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

可选。指定广告素材的展开方向。

必需且仅对第三方展开式广告有效。

第三方展开式广告是指具有以下托管来源的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

可选。表示广告素材会在鼠标悬停时自动展开。

可选，仅对第三方展开式广告有效。第三方展开式广告是指具有以下托管来源的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

可选。第三方 VAST 代码广告素材的 VAST 代码网址。

必需且仅对第三方 VAST 代码广告素材有效。

第三方 VAST 代码广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

仅供输出。表示第三方 VAST 代码广告素材需要 VPAID（数字视频播放器-广告界面）。

仅适用于输出，仅适用于第三方 VAST 代码广告素材。

第三方 VAST 代码广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

仅供输出。表示第三方 VAST 代码广告素材需要 HTML5 视频支持。

仅适用于输出，仅适用于第三方 VAST 代码广告素材。

第三方 VAST 代码广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

仅供输出。与此广告素材关联的订单项的 ID。

若要将广告素材与订单项相关联，请改用 LineItem.creative_ids。
mp3Audio

boolean

仅供输出。表示第三方音频广告素材支持 MP3。

仅适用于输出内容，且仅对第三方音频广告素材有效。

第三方音频广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

仅供输出。表示第三方音频广告素材支持 OGG。

仅适用于输出内容，且仅对第三方音频广告素材有效。

第三方音频广告素材是具有以下 hostingSource 的广告素材：

  • HOSTING_SOURCE_THIRD_PARTY

并具有以下 creativeType：

  • CREATIVE_TYPE_AUDIO

HostingSource

广告素材的可能托管来源。表示广告素材的创建和托管位置。

枚举
HOSTING_SOURCE_UNSPECIFIED 此版本中未指定托管来源或托管来源未知。
HOSTING_SOURCE_CM

从 Campaign Manager 360 同步过来的广告素材。

此托管类型不支持创建和更新方法。
HOSTING_SOURCE_THIRD_PARTY

由第三方广告服务器 (3PAS) 托管的广告素材。

如果 creativeType 是以下类型之一，则此托管类型支持创建和更新方法：

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

在 DV360 中创建并由 Campaign Manager 360 托管的广告素材。

如果 creativeType 是以下类型之一，则此托管类型支持创建和更新方法：

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

在 Studio 中创建并由 Campaign Manager 360 托管的富媒体广告素材。

此托管类型不支持创建和更新方法。

CreativeAttribute

广告素材的可能属性。

枚举
CREATIVE_ATTRIBUTE_UNSPECIFIED 该版本中未指定或未指定广告素材属性。
CREATIVE_ATTRIBUTE_VAST 广告素材是 VAST 广告素材。
CREATIVE_ATTRIBUTE_VPAID_LINEAR 广告素材是线性 VPAID 广告素材。
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR 广告素材是非线性 VPAID 广告素材。

ReviewStatusInfo

广告素材的审核状态。

JSON 表示法 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
字段
approvalStatus

enum (ApprovalStatus)

表示广告素材开始投放所需的基本审批。creativeAndLandingPageReviewStatus 和 contentAndPolicyReviewStatus 的摘要。
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

广告素材的广告素材和着陆页的审核状态。
contentAndPolicyReviewStatus

enum (ReviewStatus)

广告素材的内容和政策审核状态。
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

广告素材的广告交易平台审核状态。
publisherReviewStatuses[]

object (PublisherReviewStatus)

广告素材的发布商审核状态。

ApprovalStatus

审批状态的可能类型。它是 creativeAndLandingPageReviewStatus 和 contentAndPolicyReviewStatus 的摘要。

枚举
APPROVAL_STATUS_UNSPECIFIED 此版本中未指定或未知类型值。
APPROVAL_STATUS_PENDING_NOT_SERVABLE 该广告素材仍在审核中，无法投放。
APPROVAL_STATUS_PENDING_SERVABLE 该广告素材已通过广告素材和着陆页审核，因此可以投放，但正在等待其他内容和政策审核。
APPROVAL_STATUS_APPROVED_SERVABLE 广告素材和着陆页审核以及内容和政策审核均已获得批准。此广告素材可以投放。
APPROVAL_STATUS_REJECTED_NOT_SERVABLE 该广告素材存在问题。您必须先修正此问题，然后才能投放它。

ReviewStatus

审核状态的可能类型。

枚举
REVIEW_STATUS_UNSPECIFIED 此版本中未指定或未知类型值。
REVIEW_STATUS_APPROVED 广告素材已获批准。
REVIEW_STATUS_REJECTED 广告素材被拒。
REVIEW_STATUS_PENDING 广告素材正在等待审核。

ExchangeReviewStatus

广告素材的广告交易平台审核状态。

JSON 表示法 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
字段
exchange

enum (Exchange)

审核广告素材的广告交易平台。
status

enum (ReviewStatus)

广告交易平台审核的状态。

PublisherReviewStatus

广告素材的发布商审核状态。

JSON 表示法 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
字段
publisherName

string

审核广告素材的发布商。
status

enum (ReviewStatus)

发布商审核的状态。

AssetAssociation

广告素材的素材资源关联。

JSON 表示法 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
字段
asset

object (Asset)

关联的资源。
role

enum (AssetRole)

相应素材资源在广告素材中的角色。

素材资源

一项资源。

JSON 表示法 
{
  "mediaId": string,
  "content": string
}
字段
mediaId

string (int64 format)

所上传素材资源的媒体 ID。这是资产的唯一标识符。可以将此 ID 传递给其他 API 调用，例如，creatives.create 可将素材资源与广告素材相关联。

媒体 ID 空间于 2023 年 4 月 5 日更新。更新 2023 年 4 月 5 日之前缓存的媒体 ID，具体方法是从关联的广告素材资源中检索新的媒体 ID，或重新上传相应的素材资源。
content

string

资产内容。对于上传的素材资源，该内容就是投放路径。

AssetRole

相应素材资源在广告素材中的角色。

枚举
ASSET_ROLE_UNSPECIFIED 此版本中未指定或未知资产角色。
ASSET_ROLE_MAIN 素材资源是广告素材的主要素材资源。
ASSET_ROLE_BACKUP 素材资源是广告素材的备用素材资源。
ASSET_ROLE_POLITE_LOAD 此素材资源是广告素材的礼让加载素材资源。
ASSET_ROLE_HEADLINE

原生广告素材的标题。

content 必须采用 UTF-8 编码，长度不超过 25 个字符。

仅以下 creativeType 支持此角色：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

原生广告素材的长标题。

content 必须采用 UTF-8 编码，长度不超过 50 个字符。

仅以下 creativeType 支持此角色：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

原生广告素材的正文。

content 必须采用 UTF-8 编码，长度不超过 90 个字符。

仅以下 creativeType 支持此角色：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

原生广告素材的长正文。

content 必须采用 UTF-8 编码，长度不超过 150 个字符。

仅以下 creativeType 支持此角色：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

要在广告素材中显示的简短易记的着陆页网址。此网址让用户大致知道在点击广告素材后会进入哪个网站。

content 必须采用 UTF-8 编码，长度不超过 30 个字符。

例如，如果着陆页网址是“http://www.example.com/page”，则图片说明网址可以是“example.com”。协议 (http://) 是可选的，但网址不能包含空格或特殊字符。

仅以下 creativeType 支持此角色：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

要在原生广告素材的号召性用语按钮上使用的文字。

content 必须采用 UTF-8 编码，长度不超过 15 个字符。

仅以下 creativeType 支持此角色：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

用于标识广告客户或品牌名称的文字。

content 必须采用 UTF-8 编码，长度不超过 25 个字符。

仅以下 creativeType 支持此角色：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

您的应用在 Google Play 商店或 iOS App Store 中的购买价格（例如 $5.99）。

请注意，此值不会自动与商店中列出的实际值同步。系统始终是保存广告素材时提供的值。

content 必须采用 UTF-8 编码，长度不超过 15 个字符。

此角色的资源处于只读状态。
ASSET_ROLE_ANDROID_APP_ID

Google Play 商店中某个 Android 应用的 ID。

您可以在应用的 Google Play 商店网址中“id”后找到此 ID。例如，在 https://play.google.com/store/apps/details?id=com.company.appname 中，标识符为 com.company.appname。

此角色的资源处于只读状态。
ASSET_ROLE_IOS_APP_ID

Apple App Store 中 iOS 应用的 ID。

此 ID 编号可在 Apple App Store 网址中找到，它是紧跟“id”后面的一串数字。例如，在 https://apps.apple.com/us/app/gmail-email-by-google/id422689480 中，ID 为 422689480。

此角色的资源处于只读状态。
ASSET_ROLE_RATING

Google Play 商店或 iOS App Store 中应用的评分。

请注意，该值不会自动与应用店中的实际评分同步。系统始终是保存广告素材时提供的值。

此角色的资源处于只读状态。
ASSET_ROLE_ICON

广告素材的图标。

此角色仅在以下 creativeType 中受支持且是必需的：

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

原生视频广告素材的封面图片。

此角色仅在以下 creativeType 中受支持且是必需的：

  • CREATIVE_TYPE_VIDEO

ExitEvent

广告素材的退出事件。

JSON 表示法 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
字段
type

enum (ExitEventType)

必需。退出事件的类型。
url

string

必需。退出事件的点击后到达网址。当 type 满足以下条件时，则必须填写此字段：

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

退出事件的点击代码的名称。

该名称在一个广告素材中必须是唯一的。

对于仅包含图片素材资源的广告素材，请将此字段留空或未设置。
reportingName

string

用于标识报告中此事件的名称。对于仅包含图片素材资源的广告素材，请将此字段留空或未设置。

ExitEventType

退出事件的类型。

枚举
EXIT_EVENT_TYPE_UNSPECIFIED 此版本中未指定或未知退出事件类型。
EXIT_EVENT_TYPE_DEFAULT 退出事件是默认事件。
EXIT_EVENT_TYPE_BACKUP 退出事件是备用退出事件。一个广告素材中可以有多个备用退出事件。

TimerEvent

广告素材的计时器事件。

JSON 表示法 
{
  "name": string,
  "reportingName": string
}
字段
name

string

必需。计时器事件的名称。
reportingName

string

必需。用于标识此计时器事件的名称。

CounterEvent

广告素材的计数器事件。

JSON 表示法 
{
  "name": string,
  "reportingName": string
}
字段
name

string

必需。计数器事件的名称。
reportingName

string

必需。用于标识报告中此计数器事件的名称。

AudioVideoOffset

音频或视频的播放时长。

JSON 表示法 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
字段
联合字段 offset。偏移的值。offset 只能是下列其中一项：
percentage

string (int64 format)

音频或视频时长的偏移量（以百分比表示）。
seconds

string (int64 format)

距离音频或视频开头的偏移量（以秒为单位）。

UniversalAdId

域名注册管理机构提供的广告素材标识符，在所有平台上都是唯一的。这是 VAST 4.0 标准的一部分。

JSON 表示法 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
字段
id

string

唯一的广告素材标识符。
registry

enum (UniversalAdRegistry)

域名注册管理机构会提供唯一广告素材标识符。

UniversalAdRegistry

域名注册管理机构在通用广告 ID 中提供唯一的广告素材标识符。

枚举
UNIVERSAL_AD_REGISTRY_UNSPECIFIED 此版本中的 Universal Ad Registry 未指定或未知。
UNIVERSAL_AD_REGISTRY_OTHER 使用自定义提供商提供通用广告 ID。
UNIVERSAL_AD_REGISTRY_AD_ID 使用广告 ID 提供通用广告 ID。
UNIVERSAL_AD_REGISTRY_CLEARCAST 使用 clearcast.co.uk 提供通用广告 ID。
UNIVERSAL_AD_REGISTRY_DV360 使用 Display & Video 360 提供通用广告 ID。
UNIVERSAL_AD_REGISTRY_CM 使用 Campaign Manager 360 提供通用广告 ID。

ThirdPartyUrl

跟踪来自第三方的网址，以跟踪用户与音频或视频广告素材的互动情况。

JSON 表示法 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
字段
type

enum (ThirdPartyUrlType)

互动类型需要通过跟踪网址进行跟踪
url

string

用于跟踪互动的跟踪网址。

提供以 https: 开头的网址（包含可选路径或查询字符串）。例如 https://www.example.com/path

ThirdPartyUrlType

互动类型需要通过第三方跟踪网址进行跟踪。

枚举
THIRD_PARTY_URL_TYPE_UNSPECIFIED 在此版本中，第三方网址的类型未指定或未知。
THIRD_PARTY_URL_TYPE_IMPRESSION 用于在音频或视频缓冲完成后统计广告素材的展示次数。
THIRD_PARTY_URL_TYPE_CLICK_TRACKING 用于跟踪用户对音频或视频的点击。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START 用于跟踪用户开始播放音频或视频的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE 用于跟踪音频或视频播放到其时长的 25% 的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT 用于跟踪音频或视频播放到其时长的 50% 的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE 用于跟踪音频或视频播放到其时长的 75% 的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE 用于跟踪音频或视频完整播放的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE 用于跟踪用户关闭音频或视频的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE 用于跟踪用户暂停音频或视频的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND 用于跟踪用户重放音频或视频的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN 用于跟踪用户全屏显示播放器的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP 用于跟踪用户停止播放音频或视频的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM 用于跟踪用户执行自定义点击（例如，点击视频热点）的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP 用于跟踪用户跳过音频或视频的次数。
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS 用于跟踪音频或视频播放到由 progressOffset 确定的偏移量的次数。

转码

表示转码的音频或视频文件的相关信息。

JSON 表示法 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
字段
name

string

转码后文件的名称。
mimeType

string

转码文件的 MIME 类型。
transcoded

boolean

用于指明转码是否成功。
dimensions

object (Dimensions)

转码后视频的尺寸。
bitRateKbps

string (int64 format)

已转码视频的转码比特率（以千比特/秒为单位）。
frameRate

number

已转码视频的帧速率（以每秒帧数为单位）。
audioBitRateKbps

string (int64 format)

已转码视频的音频串流的比特率，或转码后音频的比特率（以千比特/秒为单位）。
audioSampleRateHz

string (int64 format)

已转码视频的音频流的采样率或已转码音频的采样率，以赫兹为单位。
fileSizeBytes

string (int64 format)

转码后文件的大小（以字节为单位）。

CmTrackingAd

Campaign Manager 360 跟踪广告。

JSON 表示法 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
字段
cmPlacementId

string (int64 format)

广告系列管理器 360 跟踪广告的展示位置 ID。
cmCreativeId

string (int64 format)

广告系列管理器 360 跟踪广告的广告素材 ID。
cmAdId

string (int64 format)

广告系列管理器 360 跟踪广告的广告 ID。

ObaIcon

广告素材的 OBA 图标

JSON 表示法 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
字段
resourceUrl

string

OBA 图标资源的网址。
resourceMimeType

string

OBA 图标资源的 MIME 类型。
position

enum (ObaIconPosition)

OBA 图标在广告素材上的位置。
dimensions

object (Dimensions)

OBA 图标的尺寸。
program

string

OBA 图标的计划。例如：“广告选择”。
landingPageUrl

string

必需。OBA 图标的着陆页网址。

只允许输入以下网域中的网址：
clickTrackingUrl

string

必需。OBA 图标的点击跟踪网址。

只允许输入以下网域中的网址：
viewTrackingUrl

string

必需。OBA 图标的浏览跟踪网址。

只允许输入以下网域中的网址：

ObaIconPosition

OBA 图标在广告素材上的位置。

枚举
OBA_ICON_POSITION_UNSPECIFIED 未指定 OBA 图标位置。
OBA_ICON_POSITION_UPPER_RIGHT 位于广告素材的右上角。
OBA_ICON_POSITION_UPPER_LEFT 位于广告素材的左上角。
OBA_ICON_POSITION_LOWER_RIGHT 位于广告素材的右下角。
OBA_ICON_POSITION_LOWER_LEFT 位于广告素材的左下角。

ExpandingDirection

第三方展开式广告的展开方向。

枚举
EXPANDING_DIRECTION_UNSPECIFIED 未指定展开方向。
EXPANDING_DIRECTION_NONE 不会向任何方向展开。
EXPANDING_DIRECTION_UP 展开。
EXPANDING_DIRECTION_DOWN 向下展开。
EXPANDING_DIRECTION_LEFT 向左展开。
EXPANDING_DIRECTION_RIGHT 向右展开。
EXPANDING_DIRECTION_UP_AND_LEFT 会向上并向左侧展开。
EXPANDING_DIRECTION_UP_AND_RIGHT 会向上和向右展开。
EXPANDING_DIRECTION_DOWN_AND_LEFT 向下和向左展开。
EXPANDING_DIRECTION_DOWN_AND_RIGHT 向下和向右展开。
EXPANDING_DIRECTION_UP_OR_DOWN 向上或向下展开。
EXPANDING_DIRECTION_LEFT_OR_RIGHT 会向左或向右展开。
EXPANDING_DIRECTION_ANY_DIAGONAL 可向任何对角方向展开。

方法

create

 创建新的广告素材。

delete

 删除广告素材。

get

 获取广告素材。

list

 列出某个广告客户名下的广告素材。

patch

 用于更新现有的广告素材。