Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Os recursos são unidades de dados compartilháveis, como imagens, vídeos, títulos e descrições, que são usados para criar diferentes tipos de anúncios em vários formatos, como display, YouTube, loja de apps e outros.
Objetos
Os objetos mais básicos na API são:
Asset:uma unidade de dados de publicidade compartilháveis.
AssetType:o tipo de conteúdo que o recurso contém, por exemplo, texto ou imagem.
AssetFieldType:como o recurso é usado. Por exemplo, um tipo de recurso de texto pode ser usado como um título ou um tipo de campo de recurso de descrição.
AssetSet: uma coleção de recursos centrada em um tema ou organizada por
campanha
AssetSetType: a classe do conjunto de recursos.
Há objetos que representam links entre recursos, conjuntos de recursos, grupos de anúncios, campanhas e clientes:
Vinculações a recursos
CustomerAsset:o link entre um cliente e um recurso.
CampaignAsset:o link entre uma campanha e um recurso.
AdGroupAsset:a vinculação entre um grupo de anúncios e um recurso.
AssetSetAsset:o link entre um conjunto de recursos e um recurso.
Vinculações a conjuntos de recursos
CustomerAssetSet:o link entre um cliente e um conjunto de recursos.
CampaignAssetSet:o link entre uma campanha e um grupo de recursos.
AdGroupAssetSet:a vinculação entre um grupo de anúncios e um conjunto de recursos.
Exemplo de recursos da campanha
Confira uma representação visual de como alguns dos objetos podem ser vinculados. O exemplo começa com campanhas na parte superior, mas a mesma hierarquia também se aplica a clientes e grupos de anúncios.
Diagrama de grupos de recursos de campanha
Antes de criar um CampaignAssetSet, crie um
Campaign e um AssetSet com
um ou mais recursos. Você pode reunir recursos para criar um inventário de todos os formatos de anúncio aplicáveis na sua campanha ou deixar que o Google Ads misture e combine os recursos disponíveis com base no canal em que o anúncio está sendo veiculado: YouTube, Gmail, Pesquisa e outros.
Tipos de recursos vinculados a anúncios
Alguns tipos de recursos podem ser vinculados diretamente aos anúncios.
Tipo de recurso
AssetFieldType
Tipo de anúncio
Vídeo
YOUTUBE_VIDEO
Anúncio de app Anúncio de engajamento no app Anúncio local Anúncio responsivo de display
Pacote de mídia
MEDIA_BUNDLE CUSTOM_LAYOUT
Anúncio de app Anúncio de upload de display
Imagem
MARKETING_IMAGE SQUARE_MARKETING_IMAGE LOGO LANDSCAPE_LOGO PORTRAIT_MARKETING_IMAGE
Anúncio de app Anúncio de engajamento no app Anúncio local Anúncio responsivo de display
Anúncio de app Anúncio de engajamento com app Anúncio local Anúncio responsivo de display Anúncio responsivo de pesquisa Anúncio de campanha inteligente
Call-to-action
CALL_TO_ACTION
Anúncio local Anúncio responsivo de display
Tipos de recursos vinculados a clientes, campanhas e grupos de anúncios
Alguns tipos de recursos podem ser vinculados a clientes, campanhas ou grupos de anúncios usando objetos de vinculação.
Tipo de recurso
AssetFieldType
Vinculação
Mutável
Mensagem comercial
BUSINESS_MESSAGE
AdGroupAsset CampaignAsset CustomerAsset
Sim
Texto
BUSINESS_NAME
CampaignAsset CustomerAsset
Não
Imagem
AD_IMAGE
AdGroupAsset CampaignAsset
Não
Imagem
BUSINESS_LOGO
CampaignAsset CustomerAsset
Não
Formulário de lead
LEAD_FORM
CampaignAsset
Sim
Promoção
PROMOÇÃO
AdGroupAsset CampaignAsset CustomerAsset
Sim
Frase de destaque
FRASES DE DESTAQUE
AdGroupAsset CampaignAsset CustomerAsset
Sim
Snippet estruturado
STRUCTURED_SNIPPET
AdGroupAsset CampaignAsset CustomerAsset
Sim
Sitelink
SITELINK
AdGroupAsset CampaignAsset CustomerAsset
Sim
App para dispositivos móveis
MOBILE_APP
AdGroupAsset CampaignAsset CustomerAsset
Sim
Frase de destaque de hotel
HOTEL_CALLOUT
AdGroupAsset CampaignAsset CustomerAsset
Sim
Ligar
LIGAR
AdGroupAsset CampaignAsset CustomerAsset
Sim
Preço
PREÇO
AdGroupAsset CampaignAsset CustomerAsset
Sim
Recursos de local
Os recursos de local são tratados de maneira diferente de outros tipos de recursos. Consulte Recursos de local para mais detalhes.
Recursos automáticos
Não é possível modificar os recursos automáticos. O
AssetSource indica se um
recurso foi criado pelo usuário ou gerado automaticamente pelo sistema. Tipos mutáveis, como sitelink, não podem ser vinculados a recursos criados automaticamente.
Tipos de recursos vinculados a grupos de recursos
Alguns tipos de recursos podem ser vinculados a tipos específicos de conjuntos de recursos.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 UTC."],[[["\u003cp\u003eAssets are shareable data units like images and text, used to build various ad types across different platforms.\u003c/p\u003e\n"],["\u003cp\u003eAssets are organized into Asset Sets and linked to Campaigns, Ad Groups, and Customers for streamlined management.\u003c/p\u003e\n"],["\u003cp\u003eSpecific Asset Types can be directly linked to ads or linked through linkage objects for greater flexibility.\u003c/p\u003e\n"],["\u003cp\u003eSome Asset Types are automatically created by the system and cannot be modified, indicated by their AssetSource.\u003c/p\u003e\n"],["\u003cp\u003eCertain Asset Types are designed to be used with specific Asset Set Types for specialized campaign setups.\u003c/p\u003e\n"]]],[],null,["Assets are units of shareable data---such as images, videos, headlines, and\ndescriptions---that are used to construct different types of ads across\nmultiple formats, such as display, YouTube, app store, and others.\n\nObjects\n\nThe most basic objects in the API are the following:\n\n- **`Asset`:** A unit of shareable advertising data\n - **`AssetType`:** The kind of content the asset contains---for example, text or image\n - **`AssetFieldType`:** How the asset is used---for example, a text asset type can be used as a headline or a description asset field type\n- **`AssetSet`** : A collection of assets centered around a theme or organized by campaign\n - **`AssetSetType`**: The class of the asset set\n\nThere are objects that represent links among assets, asset sets, ad groups,\ncampaigns, and customers:\n\n- Linkages to assets\n\n - **`CustomerAsset`:** The link between a customer and an asset\n - **`CampaignAsset`:** The link between a campaign and an asset\n - **`AdGroupAsset`:** The link between an ad group and an asset\n - **`AssetSetAsset`:** The link between an asset set and an asset\n- Linkages to asset sets\n\n - **`CustomerAssetSet`:** The link between a customer and an asset set\n - **`CampaignAssetSet`:** The link between a campaign and an asset set\n - **`AdGroupAssetSet`:** The link between an ad group and an asset set\n\nCampaign assets example\n\nHere's a visual representation of how some of the objects can be linked. The\nexample starts with campaigns at the top, but the same hierarchy also applies to\ncustomers and ad groups.\nDiagram of campaign asset sets\n\nBefore you create a `CampaignAssetSet`, you must first create a\n[`Campaign`](/google-ads/api/docs/campaigns/create-campaigns) and an `AssetSet` containing\none or more assets. You can assemble assets to create an inventory for all\napplicable ad formats in your campaign, or let Google Ads mix and match available\nassets based on which channel the ad is being served: YouTube, Gmail, Search,\nand others.\n| **Key Point:** A `Campaign` can link to one or more `CampaignAssetSet` objects, but each `CampaignAssetSet` can be linked to only one `Campaign`.\n\nAsset types linked to ads\n\nSome asset types can be linked directly to ads.\n\n| Asset type | AssetFieldType | Ad type |\n|----------------|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|\n| Video | YOUTUBE_VIDEO | App ad App engagement ad Local ad Responsive display ad |\n| Media bundle | MEDIA_BUNDLE CUSTOM_LAYOUT | App ad Display upload Ad |\n| Image | MARKETING_IMAGE SQUARE_MARKETING_IMAGE LOGO LANDSCAPE_LOGO PORTRAIT_MARKETING_IMAGE | App ad App engagement ad Local ad Responsive display ad |\n| Text | HEADLINE LONG_HEADLINE DESCRIPTION MANDATORY_AD_TEXT CALL_TO_ACTION_SELECTION BUSINESS_NAME | App ad App engagement ad Local ad Responsive display ad Responsive search ad Smart campaign ad |\n| Call to Action | CALL_TO_ACTION | Local ad Responsive display ad |\n\nAsset types linked to customers, campaigns, and ad groups\n\nSome types of assets can be linked to customers, campaigns, or ad groups through\nlinkage objects.\n| **Note:** For `BUSINESS_MESSAGE` assets:\n|\n| - Each customer can have only one active business message asset.\n| - At the campaign and ad group levels, you can assign only one active business message asset for each message provider type.\n\n| Asset type | AssetFieldType | Linkage | Mutable |\n|--------------------|--------------------|------------------------------------------|---------|\n| Business message | BUSINESS_MESSAGE | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Text | BUSINESS_NAME | CampaignAsset CustomerAsset | No |\n| Image | AD_IMAGE | AdGroupAsset CampaignAsset | No |\n| Image | BUSINESS_LOGO | CampaignAsset CustomerAsset | No |\n| Lead form | LEAD_FORM | CampaignAsset | Yes |\n| Promotion | PROMOTION | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Callout | CALLOUT | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Structured snippet | STRUCTURED_SNIPPET | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Sitelink | SITELINK | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Mobile app | MOBILE_APP | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Hotel callout | HOTEL_CALLOUT | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Call | CALL | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Price | PRICE | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n\nLocation assets\n\nLocation assets are handled differently from other asset types. See [Location\nassets](/google-ads/api/docs/assets/location-assets) for details.\n\nAutomatically created assets\n\nAutomatically created assets cannot be modified. The\n[`AssetSource`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource) indicates whether an\nasset was user-created or was automatically generated by the system. Mutable\ntypes like sitelink can't be linked to automatically created assets.\n\nAsset types linked to asset sets\n\nCertain asset types can be linked to specific types of asset sets.\n\n| AssetType | AssetSetType | Linkage | Mutable |\n|----------------------------|------------------------------|---------------------------------------------------|-----------------------|\n| PAGE_FEED | PAGE_FEED | CampaignAssetSet | Yes |\n| DYNAMIC_EDUCATION | DYNAMIC_EDUCATION | CampaignAssetSet | Yes |\n| DYNAMIC_CUSTOM | DYNAMIC_CUSTOM | CampaignAssetSet | Yes |\n| DYNAMIC_HOTELS_AND_RENTALS | DYNAMIC_HOTELS_AND_RENTALS | CampaignAssetSet | Yes |\n| DYNAMIC_REAL_ESTATE | DYNAMIC_REAL_ESTATE | CampaignAssetSet | Yes |\n| DYNAMIC_LOCAL | DYNAMIC_LOCAL | CampaignAssetSet | Yes |\n| DYNAMIC_FLIGHTS | DYNAMIC_FLIGHTS | CampaignAssetSet | Yes |\n| DYNAMIC_JOBS | DYNAMIC_JOBS | CampaignAssetSet | Yes |\n| DYNAMIC_TRAVEL | DYNAMIC_TRAVEL | CampaignAssetSet | Yes |\n| LOCATION | LOCATION_SYNC | CustomerAssetSet CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | GMB_DYNAMIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | CHAIN_DYNAMIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | STATIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |"]]
