Google Ads API는 Google Ads에서 직접 관리하는 자동 확장 소재를 지원하며, API 범위는 개별 확장 소재를 일시중지하거나 삭제하고 통계를 검색하는 것으로 제한됩니다. Google Ads 웹 인터페이스를 통해 자동 확장 소재를 선택하거나 선택 해제할 수 있습니다.
생성 및 업데이트
계정에서 이 기능을 선택하면 Google Ads에서 다음과 같이 자동 확장 소재를 생성합니다.
연결을 일시중지하면 애셋이 해당 항목에 대해 일시적으로 게재되지 않습니다. 연결을 일시중지하면 웹 인터페이스 또는 API를 통해 다시 사용 설정될 때까지 Google Ads에서 해당 리소스에 대해 자동으로 다시 사용 설정하거나 관련 확장 소재를 게재하지 않습니다. 애셋과 리소스 간의 연결을 영구적으로 사용 중지하려면 연결을 삭제하세요.
Google Ads에서는 특정 유형의 자동 확장 소재가 특정 항목(예: 캠페인당 자동 사이트 링크 수)과 연결될 수 있는 수를 제한합니다. 일시중지된 연결은 이 한도에 포함되지만 삭제된 연결은 포함되지 않습니다. 자동 확장 소재는 수동으로 추가된 확장 소재의 한도에 포함되지 않습니다.
[[["이해하기 쉬움","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(UTC)"],[[["\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."]]
