Uaktualnienie do najnowszej wersji

Okresowo warto uaktualnić starszą wersję główną interfejsu Google Ads API do nowszej wersji głównej. Ta wersja może być wycofywana lub chcesz używać nowej funkcji. Zalecamy zawsze uaktualnienie do najnowszej wersji.

Aby zaplanować uaktualnienia, zapoznaj się z harmonogramem wycofywania. Informacje o tym, jak działa obsługa wersji, znajdziesz w przewodniku dotyczącym obsługi wersji.

Oto lista kontrolna, która pomoże Ci rozpocząć proces uaktualnienia:

  1. Gdy zmienisz wersje główne, Twój punkt końcowy zmieni się. Zaktualizuj biblioteki klienta, aby używać najnowszego punktu końcowego.
  2. Zapoznaj się z informacjami o wersji, aby sprawdzić zmiany, które zostały wprowadzone w każdej z nich.
  3. W tabelach poniżej znajdziesz informacje o obszarach, na których należy się skupić w wersji, na którą przechodzisz.

Kompleksowe omówienie zmian na podstawie różnic między protokołami w 2 wersjach znajdziesz w tabeli różnic.

Wersje od 15 do 16

Zmiany w usługach i ich składnikach
AccountLink Linki data_partner i google_ads w domenie linked_account zostały usunięte. Użyj w zamian ProductLinkService i ProductLinkInvitationService.
CampaignLifecycleGoal Wcześniejsza aktualizacja istniejącej instancji CampaignLifecycleGoal wiązała się z działaniem operacji create z określonymi wymaganiami. Teraz możesz wykonać operację update tak jak w przypadku innych typów zasobów.
Raportowanie błędów W 2 przypadkach, w których został zwrócony ogólny błąd ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT, są teraz bardziej szczegółowe komunikaty o błędach:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata Pole score zostało usunięte.
KeywordMatchTypeRecommendation Jeśli typ dopasowania słowa kluczowego nie jest określony, interfejs API zwraca teraz w polu recommended_match_type wartość UNSPECIFIED zamiast UNKNOWN.

Wersje 14–15

Zmiany w usługach i ich składnikach
AssetGroupListingGroupFilter Nazwa pola wyliczenia vertical została zmieniona na feed_type.
MediaFileService Usługa została usunięta, ponieważ nie jest już potrzebna. Zobacz zmianę dotyczącą ImageAdInfo poniżej.
ImageAdInfo Pole media_file zostało zastąpione wartością image_asset.
MerchantCenterLinkService Usługa została zastąpiona przez ProductLinkInvitationService i ProductLinkService.
Campaign.ShoppingSetting Pole sales_country zostało usunięte. Informacje będą teraz zwracane w polu feed_label.
ProductBiddingCategoryConstant Zastąpione przez ProductCategoryConstant. Nazwy wielu pól zostały odpowiednio zmienione. Zobacz 3 następne zmiany poniżej.
ListingDimensionInfo Pole product_bidding_category zastąpiono wartością product_category.
ListingGroupFilterDimension Pole product_bidding_category zastąpiono wartością product_category.
shopping_performance_viewraport Te pola segmentów:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
zostały zastąpione przez:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting Wycofaliśmy obsługę tworzenia kampanii w sieci wyszukiwania z użyciem tego pola.
CampaignCriterion.listing_scope Wycofaliśmy obsługę tworzenia kampanii w sieci wyszukiwania z użyciem tego pola.
sk_ad_network_conversionsraport Pole metrics.sk_ad_network_conversions zostało zastąpione przez metrics.sk_ad_network_installs.
OfflineConversionClientSummary Przenieśliśmy pole offline_conversion_client_summaries z tabeli Customer do zasobu najwyższego poziomu, do którego można wysyłać osobne zapytania.

Zmień zapytanie z:

SELECT customer.offline_conversion_client_summaries
FROM customer
na: 
SELECT
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.total_event_count,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.last_upload_date_time,
  ...
FROM offline_conversion_upload_client_summary

Użyj konstruktora zapytań, aby przejrzeć listę dostępnych pól do wyboru i filtrowania.
OfflineConversionUploadAlert Nazwa została zmieniona na OfflineConversionAlert.
OfflineConversionUploadError Nazwa została zmieniona na OfflineConversionError.
AdNetworkType Wyliczenia YOUTUBE_SEARCH i YOUTUBE_WATCH zostały scalone w 1 wyliczenie: YOUTUBE.