Como migrar serviços da API Google AdWords para os serviços da API Google Ads

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A API Google Ads tem a maioria das mesmas funcionalidades que a API AdWords, mas um pequeno número de serviços mudou. Alguns foram descontinuados, alguns foram divididos em vários novos serviços e outros foram consolidados em um único serviço.

Para ajudar na sua migração para a API Google Ads, veja abaixo uma lista abrangente de todos os serviços do Google AdWords e as equivalentes na API Google Ads.

Serviço da API AdWordsServiço equivalente da API Google Ads
AccountLabelService LabelService

Os rótulos no nível da conta agora são chamados apenas de Labels.

AdCustomizerFeedService FeedService
CustomerFeedService
CampaignFeedService
AdGroupFeedService
FeedMappingService

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

AdGroupAdService AdGroupAdService

AdGroupAdService é usado para criar e modificar anúncios do grupo de anúncios. Saiba mais.

AdGroupBidModifierService AdGroupBidModifierService
AdGroupCriterionService AdGroupCriterionService
AdGroupExtensionSettingService AdGroupExtensionSettingService

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

AdGroupFeedService AdGroupFeedService

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

AdGroupService AdGroupService
AdParamService AdParameterService
AdService AdService
AdwordsUserListService OfflineUserDataJobService
UserListService

Use OfflineUserDataJobService para modificar membros de uma lista de usuários existente e UserListService para modificar e ler listas de usuários. Saiba mais

AssetService AssetService

Saiba mais.

BatchJobService BatchJobService

Saiba mais.

BiddingStrategyService BiddingStrategyService

Saiba mais.

BudgetOrderService AccountBudgetProposalService
BillingSetupService
PaymentsAccountService

Os serviços que agora compõem o faturamento permitem a configuração de pagamentos e a criação de orçamento da conta. Para relatórios de orçamento, confira account_budget.

BudgetService CampaignBudgetService

Saiba mais.

CampaignBidModifierService CampaignBidModifierService

Saiba mais.

CampaignCriterionService CampaignCriterionService
CampaignExtensionSettingService CampaignExtensionSettingService

Saiba mais.

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

CampaignFeedService CampaignFeedService

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

CampaignGroupPerformanceTargetService DEPRECATED
CampaignGroupService DEPRECATED
CampaignService CampaignService

Saiba mais.

CampaignSharedSetService CampaignSharedSetService
ConstantDataService GoogleAdsService

O mapeamento do tipo de retorno do método ConstantDataService para o tipo da API Google Ads é o seguinte:

  • getAgeRangeCriterion -> AgeRangeTypeEnum
  • getCarrierCriterion -> CarrierConstant
  • getGenderCriterion -> GenderTypeEnum
  • getLanguageCriterion -> LanguageConstant
  • getMobileAppCategoryCriterion -> MobileAppCategoryConstant
  • getMobileDeviceCriterion -> MobileDeviceConstant
  • getOperatingSystemVersionCriterion -> OperatingSystemVersionConstant
  • getProductBiddingCategoryData -> ProductBiddingCategoryConstant
  • getUserInterestCriterion -> UserInterest
  • getVerticalCriterion -> TopicConstant

Use GoogleAdsService.search ou GoogleAdsService.searchStream para recuperar qualquer um desses recursos, com exceção das faixas etárias e gêneros, que agora são representados como AgeRangeTypeEnum e GenderTypeEnum, respectivamente. Saiba mais.

ConversionTrackerService ConversionActionService
RemarketingActionService

Na Google AdWords API, as ações de conversão e de remarketing estavam disponíveis usando ConversionTrackerService, com ações de remarketing representadas como objetos AdWordsConversionTracker imutáveis com status=HIDDEN e category=REMARKETING.

Na API Google Ads, as ações de remarketing são um tipo de recurso separado gerenciado usando RemarketingActionService.

CustomAffinityService CustomInterestService

Para acessar dados de interesse personalizados, consulte o recurso custom_interest usando a Pesquisa.

CustomerExtensionSettingService CustomerExtensionSettingService

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

CustomerFeedService CustomerFeedService

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

CustomerNegativeCriterionService CustomerNegativeCriterionService
CustomerService CustomerService

Saiba mais.

CustomerSyncService

Consulte o recurso de relatório: change_status.

Saiba mais.

DataService

Consulte estes recursos de relatório:
ad_group_criterion_simulation
ad_group_simulation
campaign_criterion_simulation

DraftAsyncErrorService CampaignDraftService

Use o método ListCampaignDraftAsyncErrors.

DraftService CampaignDraftService
FeedItemService FeedItemService

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

FeedItemTargetService FeedItemTargetService
FeedMappingService FeedMappingService

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

FeedService FeedService

Saiba mais.

Observação: as extensões com base em feed estão programadas para descontinuação a partir de outubro de 2021. Consulte Migrar extensões baseadas em feed.

LabelService AdGroupAdLabelService
AdGroupCriterionLabelService
AdGroupLabelService
CampaignLabelService
CustomerLabelService

A recuperação de rótulos é feita pelo LabelService, mas as mutações são feitas usando serviços totalmente novos em vez de métodos em serviços específicos dos recursos. Por exemplo, na API AdWords, a modificação do rótulo de uma campanha é feita com o método CampaignService.mutatelabel, mas, na API Google Ads, com CampaignLabelService. Todos os métodos #mutatelabel foram movidos para novos serviços da seguinte maneira:

  • AdGroupAdService#mutatelabel -> AdGroupAdLabelService
  • AdGroupCriterionService#mutatelabel -> AdGroupCriterionLabelService
  • AdGroupService#mutatelabel -> AdGroupLabelService
  • CampaignService#mutatelabel -> CampaignLabelService
  • ManagedCustomerService#mutatelabel -> CustomerLabelService

Para modificar os rótulos da conta, use o LabelService no Google Ads.

LocationCriterionService GeoTargetConstantService

Saiba mais.

ManagedCustomerService CustomerClientLinkService
CustomerManagerLinkService

Para modificar vinculações de clientes e clientes, use o método CustomerClientLinkService. Para modificar vinculações de administradores do cliente, use o CustomerManagerLinkService. Para atrair clientes, use o recurso de relatório customer_client.

MediaService MediaFileService
OfflineCallConversionFeedService ConversionUploadService

Para fazer o upload de conversões de chamada off-line, use o método UploadCallConversions na ConversionUploadService.

OfflineConversionAdjustmentFeedService ConversionAdjustmentUploadService
OfflineConversionFeedService ConversionUploadService

Para fazer o upload de conversões de cliques off-line, use o método UploadClickConversions.

OfflineDataUploadService OfflineUserDataJobService

Use OfflineUserDataJobService para uploads em massa assíncronos de dados de Segmentação por lista de clientes e transações diretas de vendas na loja.

ReportDefinitionService GoogleAdsFieldService

Em vez de recuperar campos de relatórios, GoogleAdsFieldService vai mostrar todos os recursos, campos de recursos, chaves de segmentação e métricas disponíveis nos métodos GoogleAdsService.search e GoogleAdsService.searchStream.

Reports GoogleAdsService

Agora, os relatórios fazem parte do modelo de consulta unificado implementado pela Pesquisa, parte de GoogleAdsService. Como os campos de relatórios são mapeados.

SharedCriterionService SharedCriterionService
SharedSetService SharedSetService
TargetingIdeaService KeywordPlanIdeaService

A categoria de negócios e o grupo de anúncios de origem foram removidos.

TrafficEstimatorService KeywordPlanAdGroupService
KeywordPlanCampaignService
KeywordPlanIdeaService
KeywordPlanService

Use esses serviços para criar uma entidade de plano de palavras-chave com grupos de anúncios, critérios etc. e o plano inteiro poderá ser cobrado. Saiba mais.

Também é possível consultar estes recursos de relatório:
keyword_plan_ad_group_keyword
keyword_plan_campaign_keyword

TrialAsyncErrorService CampaignExperimentService

Use o método ListCampaignExperimentAsyncErrors.

TrialService CampaignExperimentService

Saiba mais.