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:
- Gdy zmienisz wersje główne, Twój punkt końcowy zmieni się. Zaktualizuj biblioteki klienta, aby używać najnowszego punktu końcowego.
- Zapoznaj się z informacjami o wersji, aby sprawdzić zmiany, które zostały wprowadzone w każdej z nich.
- 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:
|
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_view raport |
Te pola segmentów:
|
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_conversions raport |
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 customerna: 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 .
|