Migracja usług interfejsu API AdWords do usług interfejsu API Google Ads

Interfejs Google Ads API ma większość funkcji znanych z interfejsu AdWords API, ale liczba niewielkiej liczby usług się zmieniła. Niektóre zostały wycofane, a niektóre są podzielone na wiele nowych usług, a niektóre zostały skonsolidowane w jednej nowej usłudze.

Aby ułatwić przejście na interfejs Google Ads API, poniżej znajdziesz kompletną listę wszystkich usług AdWords i ich odpowiedników w Google Ads API.

Usługa interfejsu API AdWordsOdpowiednik usługi interfejsu Google Ads API
AccountLabelService LabelService

Etykiety na poziomie konta są teraz nazywane po prostu „Labels”.

AdCustomizerFeedService FeedService
CustomerFeedService
CampaignFeedService
AdGroupFeedService
FeedMappingService

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

AdGroupAdService AdGroupAdService

AdGroupAdService służy do tworzenia mutacji reklam w grupie reklam. Więcej informacji

AdGroupBidModifierService AdGroupBidModifierService
AdGroupCriterionService AdGroupCriterionService
AdGroupExtensionSettingService AdGroupExtensionSettingService

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

AdGroupFeedService AdGroupFeedService

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

AdGroupService AdGroupService
AdParamService AdParameterService
AdService AdService
AdwordsUserListService OfflineUserDataJobService
UserListService

Użyj OfflineUserDataJobService, aby wprowadzić mutacje do istniejącej listy użytkowników, i UserListService, aby wprowadzić mutacje do listy użytkowników i je przeczytać. Więcej informacji

AssetService AssetService

Więcej informacji

BatchJobService BatchJobService

Więcej informacji

BiddingStrategyService BiddingStrategyService

Więcej informacji

BudgetOrderService AccountBudgetProposalService
BillingSetupService
PaymentsAccountService

Usługi, które składają się obecnie na płatności, umożliwiają konfigurację płatności i tworzenie budżetu konta. Raporty o budżecie znajdziesz na stronie account_budget.

BudgetService CampaignBudgetService

Więcej informacji

CampaignBidModifierService CampaignBidModifierService

Więcej informacji

CampaignCriterionService CampaignCriterionService
CampaignExtensionSettingService CampaignExtensionSettingService

Więcej informacji

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

CampaignFeedService CampaignFeedService

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

CampaignGroupPerformanceTargetService DEPRECATED
CampaignGroupService DEPRECATED
CampaignService CampaignService

Więcej informacji

CampaignSharedSetService CampaignSharedSetService
ConstantDataService GoogleAdsService

Mapowanie z typu zwracanej metody ConstantDataService na typ interfejsu API Google Ads wygląda tak:

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

Użyj GoogleAdsService.search lub GoogleAdsService.searchStream, aby pobrać dowolny z tych zasobów z wyjątkiem przedziałów wiekowych i płci, które są obecnie reprezentowane odpowiednio jako AgeRangeTypeEnum i GenderTypeEnum. Więcej informacji

ConversionTrackerService ConversionActionService
RemarketingActionService

W interfejsie AdWords API zarówno działanie powodujące konwersję, jak i działania remarketingowe były dostępne za pomocą ConversionTrackerService, a działania remarketingowe są przedstawiane jako stałe obiekty AdWordsConversionTracker z status=HIDDEN i category=REMARKETING.

W interfejsie Google Ads API działania remarketingowe to odrębny typ zasobów, którym zarządza RemarketingActionService.

CustomAffinityService CustomInterestService

Aby uzyskać niestandardowe zapytanie o dane zainteresowań, użyj zasobu custom_interest za pomocą wyszukiwarki.

CustomerExtensionSettingService CustomerExtensionSettingService

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

CustomerFeedService CustomerFeedService

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

CustomerNegativeCriterionService CustomerNegativeCriterionService
CustomerService CustomerService

Więcej informacji

CustomerSyncService

Utwórz zapytanie do zasobu raportu: change_status.

Więcej informacji

DataService

Utwórz zapytanie dotyczące tych zasobów raportu:
ad_group_criterion_simulation
ad_group_simulation
campaign_criterion_simulation

DraftAsyncErrorService CampaignDraftService

Użyj metody ListCampaignDraftAsyncErrors.

DraftService CampaignDraftService
FeedItemService FeedItemService

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

FeedItemTargetService FeedItemTargetService
FeedMappingService FeedMappingService

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

FeedService FeedService

Więcej informacji

Uwaga: rozszerzenia oparte na plikach danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na plikach danych.

LabelService AdGroupAdLabelService
AdGroupCriterionLabelService
AdGroupLabelService
CampaignLabelService
CustomerLabelService

Pobieranie etykiet odbywa się za pomocą LabelService. Jednak mutacje są realizowane przez całkowicie nowe usługi, a nie w ramach usług specyficznych dla zasobu. Na przykład w interfejsie API AdWords stosowanie mutacji kampanii odbywało się przy użyciu metody CampaignService.mutatelabel, a w interfejsie Google Ads API za pomocą CampaignLabelService. Wszystkie metody #mutatelabel zostały przeniesione do nowych usług w ten sposób:

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

Aby zmienić Etykiety konta, użyj LabelService w Google Ads.

LocationCriterionService GeoTargetConstantService

Więcej informacji

ManagedCustomerService CustomerClientLinkService
CustomerManagerLinkService

Aby wprowadzić mutacje do linków klienta, użyj CustomerClientLinkService. Aby wprowadzić mutacje do linków menedżera klienta, użyj CustomerManagerLinkService. Aby znaleźć klientów, użyj zasobu raportu customer_client.

MediaService MediaFileService
OfflineCallConversionFeedService ConversionUploadService

Aby przesłać konwersje offline, użyj metody UploadCallConversions na stronie ConversionUploadService.

OfflineConversionAdjustmentFeedService ConversionAdjustmentUploadService
OfflineConversionFeedService ConversionUploadService

Aby przesłać konwersje offline po kliknięciu, użyj metody UploadClickConversions.

OfflineDataUploadService OfflineUserDataJobService

Użyj właściwości OfflineUserDataJobService do asynchronicznego przesyłania zbiorczego danych kierowania na listę klientów i transakcji bezpośrednich sprzedaży w sklepie.

ReportDefinitionService GoogleAdsFieldService

Zamiast pobierać pola raportów GoogleAdsFieldService wyświetla wszystkie zasoby, pola zasobów, klucze podziału i dane dostępne w metodach GoogleAdsService.search i GoogleAdsService.searchStream.

Reports GoogleAdsService

Raportowanie jest teraz częścią ujednoliconego modelu zapytania wdrożonego w wyszukiwarce, części GoogleAdsService. Jak są mapowane pola raportowania

SharedCriterionService SharedCriterionService
SharedSetService SharedSetService
TargetingIdeaService KeywordPlanIdeaService

Kategoria działalności i grupa reklam wyjściowych zostały usunięte.

TrafficEstimatorService KeywordPlanAdGroupService
KeywordPlanCampaignService
KeywordPlanIdeaService
KeywordPlanService

Korzystając z tych usług, możesz utworzyć element planu słów kluczowych z grupami reklam, kryteriami itp., a cały plan możesz wycenić. Więcej informacji

Możesz też utworzyć zapytanie dotyczące tych zasobów raportu:
keyword_plan_ad_group_keyword
keyword_plan_campaign_keyword

TrialAsyncErrorService CampaignExperimentService

Użyj metody ListCampaignExperimentAsyncErrors.

TrialService CampaignExperimentService

Więcej informacji