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 znanych z interfejsu AdWords API, ale niewielka liczba usług uległa zmianie. Niektóre zostały wycofane, inne są podzielone na wiele nowych usług, a inne zostały połączone w jedną nową.

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

Usługa AdWords APIOdpowiednik usługi interfejsu Google Ads API
AccountLabelService LabelService

Etykiety na poziomie konta są teraz nazywane Labels.

AdCustomizerFeedService FeedService
CustomerFeedService
CampaignFeedService
AdGroupFeedService
FeedMappingService

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

AdGroupAdService AdGroupAdService

AdGroupAdService jest używany do tworzenia i zmiany reklam w grupie reklam. Więcej informacji

AdGroupBidModifierService AdGroupBidModifierService
AdGroupCriterionService AdGroupCriterionService
AdGroupExtensionSettingService AdGroupExtensionSettingService

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

AdGroupFeedService AdGroupFeedService

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

AdGroupService AdGroupService
AdParamService AdParameterService
AdService AdService
AdwordsUserListService OfflineUserDataJobService
UserListService

Użyj OfflineUserDataJobService, aby wprowadzić zmiany na liście obecnych użytkowników lub UserListService i zmienić listy 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ą teraz konfigurację płatności i tworzenie budżetu konta. Raporty dotyczące budżetu 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 pliku danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na pliku danych.

CampaignFeedService CampaignFeedService

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

CampaignGroupPerformanceTargetService DEPRECATED
CampaignGroupService DEPRECATED
CampaignService CampaignService

Więcej informacji

CampaignSharedSetService CampaignSharedSetService
ConstantDataService GoogleAdsService

Mapowanie z typu zwracanego przez 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. Wyjątek stanowią przedziały wiekowe i płcie, które są obecnie reprezentowane odpowiednio jako AgeRangeTypeEnum i GenderTypeEnum. Więcej informacji

ConversionTrackerService ConversionActionService
RemarketingActionService

W interfejsie AdWords zarówno działania 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 zasobu, którym zarządza RemarketingActionService.

CustomAffinityService CustomInterestService

Aby uzyskać niestandardowe dane o zainteresowaniach, wyślij zapytanie do zasobu custom_interest za pomocą wyszukiwarki.

CustomerExtensionSettingService CustomerExtensionSettingService

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

CustomerFeedService CustomerFeedService

Uwaga: rozszerzenia oparte na pliku danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na pliku 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 pliku danych zostaną wycofane w październiku 2021 r. Zobacz Migracja rozszerzeń opartych na pliku danych.

FeedItemTargetService FeedItemTargetService
FeedMappingService FeedMappingService

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

FeedService FeedService

Więcej informacji

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

LabelService AdGroupAdLabelService
AdGroupCriterionLabelService
AdGroupLabelService
CampaignLabelService
CustomerLabelService

Etykiety można pobierać za pomocą LabelService. Jednak w przypadku mutacji stosowana jest całkowicie nowa usługa, a nie metody dotyczące zasobów. W interfejsie AdWords API na przykład mutację kampanii zmieniono za pomocą metody 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

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

LocationCriterionService GeoTargetConstantService

Więcej informacji

ManagedCustomerService CustomerClientLinkService
CustomerManagerLinkService

Aby zmienić linki klientów na klienta, użyj CustomerClientLinkService. Aby zmienić linki menedżera klienta, użyj CustomerManagerLinkService. Aby pozyskać 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 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 pokazuje wszystkie pola zasobów, zasobów i kluczy podziału, a także dane dostępne w metodach GoogleAdsService.search i GoogleAdsService.searchStream.

Reports GoogleAdsService

Raportowanie jest teraz częścią ujednoliconego modelu zapytania zaimplementowanego za pomocą wyszukiwarki, który jest częścią GoogleAdsService. Mapowanie pól 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