自动生成的素材资源
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
Google Ads API 支持由 Google Ads 直接管理的自动化素材资源,该 API 的范围仅限于暂停或移除单个素材资源以及检索统计信息。您可以通过 Google Ads 网页界面选择启用或停用自动生成的素材资源。
创建和更新
账号选择启用此功能后,Google Ads 会按如下方式创建自动生成的素材资源:
- 已创建资产。
- 系统会创建
CampaignAsset
、AdGroupAsset
或 CustomerAsset
对象,以将素材资源分别与广告系列、广告组或客户资源相关联。
您无法使用 Google Ads API 制作或更新自动生成的素材资源,也无法使用 Google Ads API 为自动生成的素材资源制作CampaignAsset
、AdGroupAsset
或 CustomerAsset
。
您可以暂停或移除将自动生成的素材资源与相应资源相关联的 CampaignAsset
、AdGroupAsset
或 CustomerAsset
实体。
暂停或移除关联
暂停关联后,相应素材资源会暂时无法针对关联的实体投放。暂停关联后,除非通过网页界面或 API 重新启用,否则 Google Ads 不会自动重新启用或针对相应资源投放相应素材资源。如需永久停用素材资源与资源之间的关联,请移除该关联。
Google Ads 会限制可与给定实体(例如每个广告系列的自动生成的站内链接)相关联的给定类型的自动生成的素材资源数量。暂停的关联计入此限额,而移除的关联则不计入。自动生成的素材资源不计入手动添加的素材资源的限额。
检索自动生成的素材资源
您可以通过过滤 AssetSource = AUTOMATICALLY_CREATED
来检索自动生成的素材资源数据。
对于可与广告相关联的素材资源,请检查其 source
。如需查看可与广告相关联的素材资源类型列表,请参阅 AssetType
。
以下是广告中素材资源的查询示例:
SELECT
ad_group.name,
ad_group_ad_asset_view.asset,
ad_group_ad_asset_view.ad_group_ad
FROM ad_group_ad_asset_view
WHERE asset.source = 'AUTOMATICALLY_CREATED'
对于其他类型的素材资源,请直接查询 Asset
资源:
SELECT
asset.id,
asset.name
FROM asset
WHERE asset.source = 'AUTOMATICALLY_CREATED'
报告
您可以从 asset_field_type_view
报告中请求获取资产效果统计信息。此报告包含自动生成的素材资源和手动添加的素材资源的汇总统计信息。
您可以从 campaign_asset
、customer_asset
和 ad_group_asset
报告中检索各个素材资源的效果统计信息。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-27。
[null,null,["最后更新时间 (UTC):2025-08-27。"],[[["\u003cp\u003eThe Google Ads API allows you to manage automated assets (created by Google Ads) by pausing, removing, or retrieving their performance data.\u003c/p\u003e\n"],["\u003cp\u003eYou can opt in or out of using automated assets through the Google Ads web interface, but cannot create or update them directly via the API.\u003c/p\u003e\n"],["\u003cp\u003ePausing an automated asset's association with a campaign, ad group, or customer temporarily disables it, while removing the association permanently disables it.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve data for automated assets using specific queries and filters within the Google Ads API.\u003c/p\u003e\n"],["\u003cp\u003ePerformance statistics for automated assets are available through various reporting features within the Google Ads API, including aggregated and individual asset data.\u003c/p\u003e\n"]]],[],null,["# Automated assets\n\nThe Google Ads API supports [automated\nassets](//support.google.com/google-ads/answer/7175034) managed directly by\nGoogle Ads, with the scope of the API limited to pausing or removing individual\nassets and retrieving stats. You opt in or out of automated assets through the\nGoogle Ads web interface.\n\nCreation and update\n-------------------\n\nOnce an account is opted in to this feature, Google Ads creates automated assets as\nfollows:\n\n1. Assets are created.\n2. [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset), [`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or [`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) objects are created to associate the asset with campaign, ad group, or customer resources, respectively.\n\nYou cannot create or update automated assets using the Google Ads API, nor can you\ncreate [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset),\n[`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or\n[`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) for the automated assets using\nthe Google Ads API.\n\nYou can pause or remove [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset),\n[`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or\n[`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) entities that associate the\nautomated asset with the corresponding resource.\n\nPause or remove the association\n-------------------------------\n\nPausing the association disables the asset from serving against the\ncorresponding entity temporarily. Once you pause the association, Google Ads won't\nautomatically re-enable or serve the corresponding asset against that resource\nuntil it is re-enabled through the web interface or API. To disable the\nassociation between asset and resource permanently, remove the association.\n\nGoogle Ads enforces a limit on the number of automated assets of a given type that\ncan be associated with a given entity, for example, the number of automated\nsitelinks per campaign. A paused association counts against this limit, whereas\na removed association doesn't. Automated assets don't count towards the limits\nfor manually added assets.\n\nRetrieve automated assets\n-------------------------\n\nYou can retrieve automated assets data by filtering for\n[`AssetSource = AUTOMATICALLY_CREATED`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource#automatically_created).\nFor assets that can link to ads, check its\n[`source`](/google-ads/api/reference/rpc/v21/AdGroupAdAssetView#source). Refer to\n[`AssetType`](/google-ads/api/reference/rpc/v21/AssetTypeEnum.AssetType) for a list of asset types\nthat can be linked to ads.\n\nHere is a sample query for assets in an ad: \n\n SELECT\n ad_group.name,\n ad_group_ad_asset_view.asset,\n ad_group_ad_asset_view.ad_group_ad\n FROM ad_group_ad_asset_view\n WHERE asset.source = 'AUTOMATICALLY_CREATED'\n\nFor other types of assets, query the [`Asset`](/google-ads/api/reference/rpc/v21/Asset) resource\ndirectly: \n\n SELECT\n asset.id,\n asset.name\n FROM asset\n WHERE asset.source = 'AUTOMATICALLY_CREATED'\n\nReports\n-------\n\nAsset performance statistics can be requested from the\n[`asset_field_type_view`](/google-ads/api/fields/v21/asset_field_type_view) report. This report\nincludes the aggregated stats for both automated and manually added assets.\n\nPerformance stats for individual assets can be retrieved from the\n[`campaign_asset`](/google-ads/api/fields/v21/campaign_asset),\n[`customer_asset`](/google-ads/api/fields/v21/customer_asset), and\n[`ad_group_asset`](/google-ads/api/fields/v21/ad_group_asset) reports."]]