Uaktualnienie do najnowszej wersji

Co jakiś czas konieczne jest uaktualnienie głównej wersji interfejsu Google Ads API do nowszej wersji głównej. Być może jest wycofywana wersja lub chcesz zacząć korzystać z nowej funkcji. Zawsze zalecamy uaktualnienie do najnowszej wersji.

Aby zaplanować uaktualnienia, sprawdź nasz harmonogram wycofywania. Aby dowiedzieć się, jak działa obsługa wersji, zapoznaj się z przewodnikiem na temat obsługi wersji.

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

  1. Gdy zmienisz wersję główną, punkt końcowy ulegnie zmianie. Zaktualizuj biblioteki klienta, aby używać najnowszego punktu końcowego.
  2. Przejrzyj informacje o wersji, by dowiedzieć się, jakie zmiany zostały wprowadzone w każdej wersji.
  3. W tabelach poniżej znajdziesz konkretne obszary, na których musisz się skupić w wersji, na którą przechodzisz.

Pełne omówienie zmian na podstawie różnic między protosami w 2 wersjach znajdziesz w tabeli różnic.

od v16 do v17

Zmiany w usługach i ich składnikach
GoogleAdsService Search i SearchStream prośby

W przypadku ograniczenia żądania, które jest zbyt kosztowne, błąd to QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION lub QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, a nie QuotaError.RESOURCE_EXHAUSTED. Więcej informacji znajdziesz w tym poście na blogu.
GoogleAdsService Search próśb.

Przekazywanie parametru page_size do metody GoogleAdsService.Search spowoduje błąd RequestError.PAGE_SIZE_NOT_SUPPORTED.
Campaign i Ad

Kampanie z AdvertisingChannelType o wartości DISCOVERY będą teraz miały AdvertisingChannelType o wartości DEMAND_GEN.

Dodatkowo niektóre reklamy zmienią typ i nazwy pól w raportach:

  • DISCOVERY_MULTI_ASSET_ADD zmieni się na DEMAND_GEN_MULTI_ASSET_ADD, a odpowiadające jej pole raportowania ad_group_ad.ad.discovery_multi_asset_ad zmieni się na ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD zmieni się na DEMAND_GEN_CAROUSEL_AD, a odpowiadające jej pole raportowania ad_group_ad.ad.discovery_carousel_ad zmieni się na ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD zmieni się na DEMAND_GEN_VIDEO_RESPONSIVE_AD, a odpowiadające jej pole raportowania ad_group_ad.ad.discovery_video_responsive_ad zmieni się na ad_group_ad.ad.demand_gen_video_responsive_ad
AdService Punkt końcowy GetAd zostanie usunięty. Dzięki temu AdService spójnie z innymi usługami w interfejsie Google Ads API. Zalecany sposób pobierania reklam i innych typów zasobów znajdziesz w przewodniku na temat pobierania obiektów.
CustomerLifecycleGoal i CampaignLifecycleGoal Zmieniliśmy sposób zarządzania segmentami na potrzeby celów cyklu życia. Pełne informacje znajdziesz w sekcji dotyczącej podziału odbiorców na segmenty w dokumentacji celów cyklu życia.
ProductLink Podczas wysyłania żądania wyszukiwania za pomocą GoogleAdsService lub strumienia wyszukiwania dla konta product_link możesz teraz wybrać tylko pola związane z 1 połączoną usługą. Jeśli wybierzesz kilka pól z różnych połączonych usług, wyświetli się błąd QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
Zdawanie relacji Nazwa pola metrics.sk_ad_network_conversion_value została zmieniona na metrics.sk_ad_network_fine_conversion_value.

od v15 do v16

Zmiany w usługach i ich składnikach
AccountLink Linki data_partner i google_ads w usłudze linked_account zostały usunięte. Zamiast nich używaj ProductLinkService i ProductLinkInvitationService.
CampaignLifecycleGoal Aktualizując wcześniej istniejący CampaignLifecycleGoal, należałoby wykonać operację create z określonymi wymaganiami. Teraz możesz wykonać operację update, tak jak w przypadku innych typów zasobów.
Raportowanie błędów 2 sytuacje, w których został zwrócony ogólny błąd ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT, skutkują teraz bardziej szczegółowymi komunikatami 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 ustawiony, interfejs API zwraca w polu recommended_match_type wartość UNSPECIFIED zamiast UNKNOWN.

od v14 do v15

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 poniżej zmianę dotyczącą ImageAdInfo.
ImageAdInfo Pole media_file zostało zastąpione polem image_asset.
MerchantCenterLinkService Usługa została zastąpiona ProductLinkInvitationService i ProductLinkService.
Campaign.ShoppingSetting Pole sales_country zostało usunięte. Informacje pojawią się teraz w polu feed_label.
ProductBiddingCategoryConstant Zastąpiony zapisem ProductCategoryConstant. Nazwy wielu pól zostały odpowiednio zmienione – zobacz następne 3 kolejne 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_view tych pól segmentu:
  • 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 Wyłączyliśmy możliwość tworzenia kampanii w sieci wyszukiwania za pomocą tego pola.
CampaignCriterion.listing_scope Wyłączyliśmy możliwość tworzenia kampanii w sieci wyszukiwania za pomocą tego pola.
sk_ad_network_conversions Element metrics.sk_ad_network_conversions został zastąpiony elementem metrics.sk_ad_network_installs.
OfflineConversionClientSummary Pole offline_conversion_client_summaries zostało przeniesione z Customer do zasobu najwyższego poziomu, do którego możesz wysyłać osobne zapytania.

Zmień zapytanie z:

SELECT customer.offline_conversion_client_summaries
FROM customer
to: 
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

Za pomocą kreatora zapytań przejrzyj listę dostępnych pól do wyboru i filtrowania.
OfflineConversionUploadAlert Zmieniono nazwę na OfflineConversionAlert.
OfflineConversionUploadError Zmieniono nazwę na OfflineConversionError.
AdNetworkType Wyliczenia YOUTUBE_SEARCH i YOUTUBE_WATCH zostały scalone w jedną wyliczenie: YOUTUBE.