[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-05 (世界標準時間)。"],[[["\u003cp\u003eRetrieve a list of assets and their attributes, including type-specific properties, using GAQL queries to the GoogleAdsService.\u003c/p\u003e\n"],["\u003cp\u003eAccess asset metrics at the ad group, campaign, and customer levels through their respective resources to analyze performance.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the \u003ccode\u003ead_group_ad_asset_view\u003c/code\u003e to gain insights into ad-level performance metrics specifically for App ads assets, including a performance label.\u003c/p\u003e\n"],["\u003cp\u003eDetermine the source of mutable assets with \u003ccode\u003eAsset.source\u003c/code\u003e and the source of RSA assets with \u003ccode\u003eAdGroupAdAsset.source\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Reports\n\nYou can get a list of assets and their attributes by sending a [Google Ads Query\nLanguage (GAQL) query](/google-ads/api/docs/query/overview) to the GoogleAdsService. Assets\nare represented by the [`asset`](/google-ads/api/fields/v21/asset) entity, which exposes a number\nof asset-specific fields.\n\nAsset attributes\n----------------\n\nThe following GAQL query lists all assets in an advertiser's account along with\ntheir resource name and type. \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.type\n FROM asset\n\nYou can add type-specific attributes this query to read properties specific to\nassets such as [`ImageAsset`](/google-ads/api/reference/rpc/v21/ImageAsset) or\n[`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset).\n\nFor example, the following query lists the YouTube video IDs for all\n[`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset) objects in an account by\nfiltering the [`asset.type`](/google-ads/api/fields/v21/asset#asset.type) value. See a list of\npossible type values) for [`YoutubeVideoAsset`](/google-ads/api/reference/rpc/v21/YoutubeVideoAsset). \n\n SELECT\n asset.id,\n asset.name,\n asset.resource_name,\n asset.youtube_video_asset.youtube_video_id\n FROM asset\n WHERE asset.type = 'YOUTUBE_VIDEO'\n\nAsset metrics\n-------------\n\nAsset metrics are made available through a few resources:\n\n- [`ad_group_asset`](/google-ads/api/fields/v21/ad_group_asset)\n- [`campaign_asset`](/google-ads/api/fields/v21/campaign_asset)\n- [`customer_asset`](/google-ads/api/fields/v21/customer_asset)\n\nWith these resources, you can query asset metrics at each respective level.\nFor example, when you query the `ad_group_asset` resource, you can use the\n`ad_group.id` field to segment the results, thereby retrieving metrics for each\nunique combination of `ad_group` and `asset`: \n\n SELECT\n ad_group.id,\n asset.id,\n metrics.clicks,\n metrics.impressions\n FROM ad_group_asset\n WHERE segments.date DURING LAST_MONTH\n ORDER BY metrics.impressions DESC\n\nAd-level metrics\n----------------\n\n| **Key Point:** The [`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view) only returns information for assets that are related to App ads.\n\nAd-level performance metrics for assets are aggregated in the\n[`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view). This view collects\nmetrics for assets per individual ad. Thus, querying this view returns one row\nper ad group and ad.\n\nThe [`ad_group_ad_asset_view`](/google-ads/api/fields/v21/ad_group_ad_asset_view) exposes the\nview-specific attribute\n[`performance_label`](/google-ads/api/reference/rpc/v21/AdGroupAdAssetView#performance_label) that\ngives insight into the performance characteristics of this specific asset-ad\npairing. The following table enumerates the possible values of the\n`performance_label` fields.\n\n| `performance_label` | Description |\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| `BEST` | Best performing assets. |\n| `GOOD` | Good performing assets. |\n| `LOW` | Worst performing assets. |\n| `LEARNING` | The asset has started getting impressions but the stats are not statistically significant enough to get an asset performance label. |\n| `PENDING` | This asset doesn't yet have any performance information. This may be because it is still under review. |\n| `UNKNOWN` | Represents value unknown in this version. |\n| `UNSPECIFIED` | Not specified. |\n\nThe following GAQL query returns impressions, clicks, costs, and conversions for\nall assets in an account during the last month, sorted by their\n`performance_label`: \n\n SELECT\n ad_group_ad_asset_view.ad_group_ad,\n ad_group_ad_asset_view.asset,\n ad_group_ad_asset_view.field_type,\n ad_group_ad_asset_view.performance_label,\n metrics.impressions,\n metrics.clicks,\n metrics.cost_micros,\n metrics.conversions\n FROM ad_group_ad_asset_view\n WHERE segments.date DURING LAST_MONTH\n ORDER BY ad_group_ad_asset_view.performance_label\n\nAsset Source\n------------\n\n[`Asset.source`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource) is only accurate for\n[`mutable`](/google-ads/api/docs/assets/overview#asset_types_linked_to_customers_campaigns_and_ad_groups)\nAssets.\n\nFor the source of RSA Assets use,\n[`AdGroupAdAsset.source`](/google-ads/api/fields/v21/ad_group_ad_asset_view#ad_group_ad_asset_view.source)."]]