A nova API Search Ads 360 Reporting já está disponível. Participe do grupo do Google searchads-api-announcements para ficar por dentro das próximas melhorias e versões.

Esta página foi traduzida pela API Cloud Translation.

recurso

O recurso é uma parte de um anúncio que pode ser compartilhado entre vários anúncios. Pode ser uma imagem (ImageAsset), um vídeo (YoutubeVideoAsset) etc. Os recursos são imutáveis e não podem ser removidos. Para interromper a veiculação de um recurso, remova-o da entidade que o usa.

Recursos atribuídos
cliente

Os campos dos recursos acima podem ser selecionados com esse recurso nas cláusulas SELECT e WHERE. Esses campos não segmentarão as métricas na sua cláusula SELECT.

asset.call_asset.ad_schedule_targets
Descrição do campo	Lista de programações não sobrepostas que especificam todos os intervalos em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total.
Categoria	`ATTRIBUTE`
Tipo de dados	`MESSAGE`
Digite o URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filtrável	Falso
Selecionável	Verdadeiro
Sortable	Falso
Repetido	Verdadeiro

asset.call_asset.call_conversion_action
Descrição do campo	A ação de conversão à qual atribuir uma conversão de chamada. Se ela não for definida, a ação de conversão padrão será usada. Esse campo só terá efeito se call_conversion_reporting_state estiver definido como USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
Categoria	`ATTRIBUTE`
Tipo de dados	`RESOURCE_NAME`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_asset.call_conversion_reporting_state
Descrição do campo	Indica se este CallAsset deve usar a própria configuração de conversão de chamada, seguir a configuração no nível da conta ou desativar a conversão de chamada.
Categoria	`ATTRIBUTE`
Tipo de dados	`ENUM DISABLED UNKNOWN UNSPECIFIED USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION`
Digite o URL	`google.ads.searchads360.v0.enums.CallConversionReportingStateEnum.CallConversionReportingState`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_asset.call_only
Descrição do campo	Indica se a chamada mostra apenas o número de telefone sem um link para o site. Válido para o Microsoft Ads.
Categoria	`ATTRIBUTE`
Tipo de dados	`BOOLEAN`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_asset.call_tracking_enabled
Descrição do campo	Se a chamada deve ou não ser ativada no acompanhamento de chamadas. Válido para o Microsoft Ads.
Categoria	`ATTRIBUTE`
Tipo de dados	`BOOLEAN`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_asset.country_code
Descrição do campo	Código do país de duas letras do número de telefone. por exemplo, "BR", "us".
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_asset.end_date
Descrição do campo	Última data em que esse recurso está em vigor e ainda é veiculado, no formato aaaa-MM-dd.
Categoria	`ATTRIBUTE`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_asset.phone_number
Descrição do campo	O número de telefone bruto do anunciante. Exemplos: "1234567890", "(123)456-7890"
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_asset.start_date
Descrição do campo	Data de início do momento em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd.
Categoria	`ATTRIBUTE`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_asset.use_searcher_time_zone
Descrição do campo	Define se a extensão de chamada será exibida no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads.
Categoria	`ATTRIBUTE`
Tipo de dados	`BOOLEAN`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.call_to_action_asset.call_to_action
Descrição do campo	Call-to-action
Categoria	`ATTRIBUTE`
Tipo de dados	`ENUM APPLY_NOW BOOK_NOW BUY_NOW CONTACT_US DONATE_NOW DOWNLOAD GET_QUOTE LEARN_MORE ORDER_NOW PLAY_NOW SEE_MORE SHOP_NOW SIGN_UP START_NOW SUBSCRIBE UNKNOWN UNSPECIFIED VISIT_SITE WATCH_NOW`
Digite o URL	`google.ads.searchads360.v0.enums.CallToActionTypeEnum.CallToActionType`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.callout_asset.ad_schedule_targets
Descrição do campo	Lista de programações não sobrepostas que especificam todos os intervalos em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total.
Categoria	`ATTRIBUTE`
Tipo de dados	`MESSAGE`
Digite o URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filtrável	Falso
Selecionável	Verdadeiro
Sortable	Falso
Repetido	Verdadeiro

asset.callout_asset.callout_text
Descrição do campo	O texto da frase de destaque. Esta string conter entre 1 e 25 caracteres (valores inclusivos).
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.callout_asset.end_date
Descrição do campo	Última data em que esse recurso está em vigor e ainda é veiculado, no formato aaaa-MM-dd.
Categoria	`ATTRIBUTE`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.callout_asset.start_date
Descrição do campo	Data de início do momento em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd.
Categoria	`ATTRIBUTE`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.callout_asset.use_searcher_time_zone
Descrição do campo	Define se o recurso será ou não exibido no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads.
Categoria	`ATTRIBUTE`
Tipo de dados	`BOOLEAN`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.creation_time
Descrição do campo	O carimbo de data/hora em que o recurso foi criada. O carimbo de data/hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss".
Categoria	`ATTRIBUTE`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.engine_status
Descrição do campo	O status do mecanismo de um recurso.
Categoria	`ATTRIBUTE`
Tipo de dados	`ENUM DISABLED DISAPPROVED REMOVED SERVING SERVING_LIMITED UNKNOWN UNSPECIFIED`
Digite o URL	`google.ads.searchads360.v0.enums.AssetEngineStatusEnum.AssetEngineStatus`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.final_urls
Descrição do campo	Uma lista de possíveis URLs finais após todos os redirecionamentos entre domínios.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Falso
Repetido	Verdadeiro

asset.id
Descrição do campo	O ID do recurso.
Categoria	`ATTRIBUTE`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.image_asset.file_size
Descrição do campo	Tamanho do arquivo do recurso de imagem em bytes.
Categoria	`ATTRIBUTE`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.image_asset.full_size.height_pixels
Descrição do campo	Altura da imagem.
Categoria	`ATTRIBUTE`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.image_asset.full_size.url
Descrição do campo	Um URL que retorna a imagem com essa altura e largura.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.image_asset.full_size.width_pixels
Descrição do campo	É a largura da imagem.
Categoria	`ATTRIBUTE`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.image_asset.mime_type
Descrição do campo	Tipo MIME do recurso de imagem.
Categoria	`ATTRIBUTE`
Tipo de dados	`ENUM AUDIO_MP3 AUDIO_WAV FLASH HTML5_AD_ZIP IMAGE_GIF IMAGE_JPEG IMAGE_PNG MSEXCEL MSWORD PDF RTF TEXT_HTML UNKNOWN UNSPECIFIED`
Digite o URL	`google.ads.searchads360.v0.enums.MimeTypeEnum.MimeType`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.last_modified_time
Descrição do campo	A data e a hora em que este recurso foi modificado pela última vez. A data e hora está no fuso horário do cliente e no formato "aaaa-MM-dd HH:mm:ss.ssssss".
Categoria	`ATTRIBUTE`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.location_asset.business_profile_locations
Descrição do campo	A lista de locais da empresa do cliente. Só vai ser retornado se o recurso de local estiver sendo sincronizado na conta do Perfil da Empresa. É possível ter várias fichas de empresas em uma mesma conta que apontam para o mesmo ID de lugar.
Categoria	`ATTRIBUTE`
Tipo de dados	`MESSAGE`
Digite o URL	`google.ads.searchads360.v0.common.BusinessProfileLocation`
Filtrável	Falso
Selecionável	Verdadeiro
Sortable	Falso
Repetido	Verdadeiro

asset.location_asset.location_ownership_type
Descrição do campo	O tipo de propriedade de local. Se o tipo for BUSINESS_OWNER, ele será veiculado como uma extensão de local. Se o tipo for AFILIADO, ele será veiculado como um local de afiliado.
Categoria	`ATTRIBUTE`
Tipo de dados	`ENUM AFFILIATE BUSINESS_OWNER UNKNOWN UNSPECIFIED`
Digite o URL	`google.ads.searchads360.v0.enums.LocationOwnershipTypeEnum.LocationOwnershipType`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.location_asset.place_id
Descrição do campo	IDs de lugares identificam um local de modo exclusivo no banco de dados do Google Places e no Google Maps. Esse campo é exclusivo para um determinado ID de cliente e tipo de recurso. Consulte https://developers.google.com/places/web-service/place-id para saber mais sobre o ID de lugar.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.mobile_app_asset.app_id
Descrição do campo	Obrigatório. Uma string que identifica exclusivamente um aplicativo para dispositivos móveis. Ele precisa conter apenas o ID nativo da plataforma, como "com.android.ebay" para Android ou "12345689" para iOS.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.mobile_app_asset.app_store
Descrição do campo	Obrigatório. A loja de aplicativos que distribui o aplicativo específico.
Categoria	`ATTRIBUTE`
Tipo de dados	`ENUM APPLE_APP_STORE GOOGLE_APP_STORE UNKNOWN UNSPECIFIED`
Digite o URL	`google.ads.searchads360.v0.enums.MobileAppVendorEnum.MobileAppVendor`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.name
Descrição do campo	Nome opcional do recurso.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.page_feed_asset.labels
Descrição do campo	Rótulos usados para agrupar os URLs da página.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Falso
Repetido	Verdadeiro

asset.page_feed_asset.page_url
Descrição do campo	A página da Web que os anunciantes querem segmentar.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.resource_name
Descrição do campo	O nome do recurso. Os nomes dos recursos têm o formato: `customers/{customer_id}/assets/{asset_id}`
Categoria	`ATTRIBUTE`
Tipo de dados	`RESOURCE_NAME`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Falso
Repetido	Falso

asset.sitelink_asset.ad_schedule_targets
Descrição do campo	Lista de programações não sobrepostas que especificam todos os intervalos em que o recurso pode ser veiculado. Pode haver no máximo seis programações por dia, 42 no total.
Categoria	`ATTRIBUTE`
Tipo de dados	`MESSAGE`
Digite o URL	`google.ads.searchads360.v0.common.AdScheduleInfo`
Filtrável	Falso
Selecionável	Verdadeiro
Sortable	Falso
Repetido	Verdadeiro

asset.sitelink_asset.description1
Descrição do campo	Primeira linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, inclusivo, e a description2 também precisa ser definida.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.sitelink_asset.description2
Descrição do campo	Segunda linha da descrição do sitelink. Se definido, o comprimento deve estar entre 1 e 35, sendo inclusivo, e a description1 também precisa ser definida.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.sitelink_asset.end_date
Descrição do campo	Última data em que esse recurso está em vigor e ainda é veiculado, no formato aaaa-MM-dd.
Categoria	`ATTRIBUTE`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.sitelink_asset.link_text
Descrição do campo	Texto de visualização do URL para o sitelink. Esta string conter entre 1 e 25 caracteres (valores inclusivos).
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.sitelink_asset.mobile_preferred
Descrição do campo	Indica se a preferência é que o recurso de sitelink seja exibido em dispositivos móveis. Válido para o Microsoft Ads.
Categoria	`ATTRIBUTE`
Tipo de dados	`BOOLEAN`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.sitelink_asset.start_date
Descrição do campo	Data de início do momento em que esse recurso entra em vigor e começa a ser veiculado, no formato aaaa-MM-dd.
Categoria	`ATTRIBUTE`
Tipo de dados	`DATE`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.sitelink_asset.tracking_id
Descrição do campo	É o ID usado para rastrear cliques do recurso de sitelink. Essa conta de cliente do Yahoo! Japan.
Categoria	`ATTRIBUTE`
Tipo de dados	`INT64`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.sitelink_asset.use_searcher_time_zone
Descrição do campo	Indica se o recurso de sitelink será exibido no fuso horário do usuário da pesquisa. Válido para o Microsoft Ads.
Categoria	`ATTRIBUTE`
Tipo de dados	`BOOLEAN`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.status
Descrição do campo	O status do recurso.
Categoria	`ATTRIBUTE`
Tipo de dados	`ENUM ARCHIVED ENABLED PENDING_SYSTEM_GENERATED REMOVED UNKNOWN UNSPECIFIED`
Digite o URL	`google.ads.searchads360.v0.enums.AssetStatusEnum.AssetStatus`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.text_asset.text
Descrição do campo	Conteúdo do recurso de texto.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.tracking_url_template
Descrição do campo	Modelo de URL para criar um URL de rastreamento.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.type
Descrição do campo	Tipo do recurso.
Categoria	`ATTRIBUTE`
Tipo de dados	`ENUM BOOK_ON_GOOGLE CALL CALLOUT CALL_TO_ACTION DISCOVERY_CAROUSEL_CARD DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHTS DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_JOBS DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL HOTEL_CALLOUT HOTEL_PROPERTY IMAGE LEAD_FORM LOCATION MEDIA_BUNDLE MOBILE_APP PAGE_FEED PRICE PROMOTION SITELINK STRUCTURED_SNIPPET TEXT UNKNOWN UNSPECIFIED YOUTUBE_VIDEO`
Digite o URL	`google.ads.searchads360.v0.enums.AssetTypeEnum.AssetType`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.youtube_video_asset.youtube_video_id
Descrição do campo	ID do vídeo do YouTube. Este é o valor de string de 11 caracteres usado no URL do vídeo do YouTube.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

asset.youtube_video_asset.youtube_video_title
Descrição do campo	Título do vídeo do YouTube.
Categoria	`ATTRIBUTE`
Tipo de dados	`STRING`
Digite o URL	`N/A`
Filtrável	Verdadeiro
Selecionável	Verdadeiro
Sortable	Verdadeiro
Repetido	Falso

recurso

asset.call_asset.ad_schedule_targets

asset.call_asset.call_conversion_action

asset.call_asset.call_conversion_reporting_state

asset.call_asset.call_only

asset.call_asset.call_tracking_enabled

asset.call_asset.country_code

asset.call_asset.end_date

asset.call_asset.phone_number

asset.call_asset.start_date

asset.call_asset.use_searcher_time_zone

asset.call_to_action_asset.call_to_action

asset.callout_asset.ad_schedule_targets

asset.callout_asset.callout_text

asset.callout_asset.end_date

asset.callout_asset.start_date

asset.callout_asset.use_searcher_time_zone

asset.creation_time

asset.engine_status

asset.final_urls

asset.id

asset.image_asset.file_size

asset.image_asset.full_size.height_pixels

asset.image_asset.full_size.url

asset.image_asset.full_size.width_pixels

asset.image_asset.mime_type

asset.last_modified_time

asset.location_asset.business_profile_locations

asset.location_asset.location_ownership_type

asset.location_asset.place_id

asset.mobile_app_asset.app_id

asset.mobile_app_asset.app_store

asset.name

asset.page_feed_asset.labels

asset.page_feed_asset.page_url

asset.resource_name

asset.sitelink_asset.ad_schedule_targets

asset.sitelink_asset.description1

asset.sitelink_asset.description2

asset.sitelink_asset.end_date

asset.sitelink_asset.link_text

asset.sitelink_asset.mobile_preferred

asset.sitelink_asset.start_date

asset.sitelink_asset.tracking_id

asset.sitelink_asset.use_searcher_time_zone

asset.status

asset.text_asset.text

asset.tracking_url_template

asset.type

asset.youtube_video_asset.youtube_video_id

asset.youtube_video_asset.youtube_video_title