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:
- Gdy zmienisz wersję główną, punkt końcowy ulegnie zmianie. Zaktualizuj biblioteki klienta, aby używać najnowszego punktu końcowego.
- Przejrzyj informacje o wersji, by dowiedzieć się, jakie zmiany zostały wprowadzone w każdej wersji.
- 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 |
GoogleAdsService
Search próśb. |
Przekazywanie parametru |
Campaign i Ad |
Kampanie z Dodatkowo niektóre reklamy zmienią typ i nazwy pól w raportach:
|
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:
|
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:
|
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 customerto: 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 .
|