报告

您可以向 GoogleAdsService 发送 Google Ads 查询语言 (GAQL) 查询，以获取素材资源及其属性的列表。资产由 asset 实体表示，该实体会公开一些特定于资产的字段。

素材资源属性

以下 GAQL 查询会列出广告客户账号中的所有素材资源，以及其资源名称和类型。

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

请注意，您可以向此查询添加类型专用属性，以读取特定于素材资源的属性，例如 ImageAsset 或 YoutubeVideoAsset。

例如，以下查询会通过过滤 YoutubeVideoAsset 的 asset.type 值（请参阅文档，查看可能的类型值列表），列出账号中所有 YoutubeVideoAsset 对象的 YouTube 视频 ID。

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

素材资源指标

您可以通过以下几个资源查看资产指标：

借助这些资源，您可以在各个级别查询素材资源指标。例如，在查询 ad_group_asset 资源时，可以使用 ad_group.id 字段对结果进行细分，从而检索 ad_group 和 asset 的每个唯一组合的指标：

SELECT
  ad_group.id,
  asset.id,
  metrics.clicks,
  metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC

广告级指标

素材资源的广告级效果指标会汇总到 ad_group_ad_asset_view 中。此视图会收集每个广告的素材资源指标。因此，查询此视图会针对每个广告组和广告返回一行。

ad_group_ad_asset_view 会公开特定于视图的属性 performance_label，以便深入了解此特定素材资源-广告配对的效果特征。下表列出了 performance_label 字段的可能值。

`performance_label`	说明
`BEST`	效果最佳的素材资源。
`GOOD`	效果出色的素材资源。
`LOW`	效果最差的素材资源。
`LEARNING`	素材资源已开始获得展示，但统计数据不具备足够的统计显著性，无法获得素材资源效果标签。
`PENDING`	此素材资源尚无任何效果信息。这可能是因为您的申请仍在审核中。
`UNKNOWN`	表示此版本中的值未知。
`UNSPECIFIED`	未指定。

以下 GAQL 查询会返回账号中所有素材资源在上个月的展示次数、点击次数、费用和转化次数，并按 performance_label 对其进行排序：

SELECT
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.field_type,
  ad_group_ad_asset_view.performance_label,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label

素材资源来源

Asset.source 仅适用于 mutable 素材资源。

对于自适应搜索广告素材资源的来源，请使用 AdGroupAdAsset.source。

自动生成的素材资源

资源