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

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Interfejs Google Ads API ma większość funkcji zbliżonych do interfejsu AdWords API, ale zmieniła się jego niewielka liczba. Niektóre zostały wycofane, inne zostały podzielone na wiele nowych, a inne zostały skonsolidowane w jedną nową usługę.

Aby ułatwić Ci 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 w usłudze Google Ads API
AccountLabelService LabelService

Etykiety na poziomie konta są teraz określane po prostu jako 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 jest używany do tworzenia i przekształcania 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

OfflineUserDataJobService służy do przekształcania członków istniejącej listy użytkowników, a UserListService do mutowania i odczytywania list użytkowników. 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ę na płatności, umożliwiają konfigurację płatności i tworzenie budżetu konta. Raporty dotyczące budżetu znajdziesz w sekcji 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 zwracania metody ConstantDataService na typ interfejsu Google Ads API wygląda tak:

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

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

ConversionTrackerService ConversionActionService
RemarketingActionService

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

W interfejsie Google Ads API działania remarketingowe to oddzielny typ zasobu, który jest zarządzany za pomocą RemarketingActionService.

CustomAffinityService CustomInterestService

Aby uzyskać niestandardowe dane dotyczące zainteresowań, użyj zapytania 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

Wyślij 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

Etykiety są pobierane za pomocą LabelService, ale mutacje są wykonywane za pomocą całkowicie nowych usług, a nie metod związanych z zasobami. W interfejsie AdWords API na przykład mutację kampanii wykonano metodą CampaignService.mutatelabel, a w interfejsie Google Ads API za pomocą metody 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

Pamiętaj, że aby zmienić etykiety kont, musisz używać LabelService w Google Ads.

LocationCriterionService GeoTargetConstantService

Więcej informacji

ManagedCustomerService CustomerClientLinkService
CustomerManagerLinkService

Do przekształcania połączeń z klientami klientów użyj CustomerClientLinkService. Do wprowadzania zmian w połączeniach z menedżerem klienta użyj polecenia CustomerManagerLinkService. Aby pozyskać klientów, użyj zasobu raportu customer_client.

MediaService MediaFileService
OfflineCallConversionFeedService ConversionUploadService

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

OfflineConversionAdjustmentFeedService ConversionAdjustmentUploadService
OfflineConversionFeedService ConversionUploadService

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

OfflineDataUploadService OfflineUserDataJobService

Używaj OfflineUserDataJobService do asynchronicznego przesyłania zbiorczego danych kierowania na listę klientów i transakcji sprzedaży w sklepie.

ReportDefinitionService GoogleAdsFieldService

Zamiast pobierać pola raportu GoogleAdsFieldService wyświetli 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 zapytań zaimplementowanego przez wyszukiwarkę, część GoogleAdsService. Jak są mapowane pola raportowania

SharedCriterionService SharedCriterionService
SharedSetService SharedSetService
TargetingIdeaService KeywordPlanIdeaService

Kategoria działalności i grupa reklam początkowych 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że zostać wyceniony. 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