Uaktualnienie do najnowszej wersji

Od czasu do czasu warto przejść z starszej głównej wersji interfejsu Google Ads API na nowszą. Przyczyną może być wycofywanie wersji, lub dlatego, że chcesz korzystać z nowej funkcji. Zalecamy zawsze przechodzenie na najnowszą wersję.

Aby zaplanować uaktualnienia, zapoznaj się z harmonogramem wycofywania. Aby dowiedzieć się więcej o wersjonalności, zapoznaj się z przewodnikiem.

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. Przeczytaj informacje o wersji, aby poznać zmiany wprowadzone w każdej wersji.
  3. W tabelach poniżej znajdziesz listę obszarów, na których warto się skupić w przypadku wersji, na którą przechodzisz.

Pełny przegląd zmian na podstawie różnic między prototypami z obu wersji znajdziesz w tabeli różnic.

v17 na v18

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

Jeśli żądanie zostanie ograniczone, ponieważ będzie zbyt drogie, pojawi się błąd być albo QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION lub QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION zamiast z QuotaError.RESOURCE_EXHAUSTED. Więcej informacji znajdziesz w tym poście na blogu.
GoogleAdsService Pola summary_row_setting i return_total_results_count w rekordzie SearchGoogleAdsRequest są teraz częścią nowego obiektu SearchSettings.
AssetType Nazwa wartości wyliczeniowej DISCOVERY_CAROUSEL_CARD została zmieniona na DEMAND_GEN_CAROUSEL_CARD Jest zgodna z poprzednią zmianą .
AudienceInsightsService.GenerateSuggestedTargetingInsights audience, baseline_audience i Pola (data_month) zostały przeniesione w obrębie tabeli audience_definition.
DemandGenCampaignSettings Wartością domyślną pola upgraded_targeting jest teraz true, a nie false.
LocalServicesLeadConversation Pole phone_call_details.call_recording_url nie będzie już dla wywołań statycznych.

z 16 na 17

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

Żądanie może zostać ograniczone, jeśli zapytanie będzie zbyt kosztowne. Jeśli tak, wystąpi QuotaError.RESOURCE_EXHAUSTED błąd. Zajrzyj na bloga .
GoogleAdsService Search prośby.

Przekazuję sygnał page_size do: GoogleAdsService.Search spowoduje wystąpienie błędu RequestError.PAGE_SIZE_NOT_SUPPORTED.
Campaign i Ad

Kampanie z AdvertisingChannelType: DISCOVERY będzie teraz mieć AdvertisingChannelType w wysokości DEMAND_GEN.

Dodatkowo zmienimy nazwy typów reklam i kolumn w raportach dotyczących tych reklam:

  • DISCOVERY_MULTI_ASSET_ADD będzie DEMAND_GEN_MULTI_ASSET_ADD i odpowiednie pole raportowania ad_group_ad.ad.discovery_multi_asset_ad będzie ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD stanie się DEMAND_GEN_CAROUSEL_AD, a odpowiadające mu pole raportowania ad_group_ad.ad.discovery_carousel_ad stanie się ad_group_ad.ad.demand_gen_carousel_ad.
  • DISCOVERY_VIDEO_RESPONSIVE_AD stanie się DEMAND_GEN_VIDEO_RESPONSIVE_AD, a odpowiadające mu pole raportowania ad_group_ad.ad.discovery_video_responsive_ad stanie się ad_group_ad.ad.demand_gen_video_responsive_ad.
AdService Punkt końcowy GetAd zostanie usunięty. Dzięki temu interfejs AdService będzie zgodny z innymi usługami w interfejsie Google Ads API. Zapoznaj się z naszym przewodnikiem po pobieraniu obiektów, aby dowiedzieć się, jak pobierać reklamy i inne typy zasobów.
CustomerLifecycleGoal i CampaignLifecycleGoal Zmieniliśmy sposób zarządzania segmentami w przypadku celów cyklu życia. Pełną listę znajdziesz w sekcji segmentacji odbiorców w dokumentacji dotyczącej celów związanych z cyklem życia.
ProductLink Podczas wyszukiwania w GoogleAdsService lub strumienia wyszukiwania prośbę dotyczącą: product_link, możesz teraz wybrać tylko pola powiązane do 1 powiązanej usługi. Wybranie wielu pól z różnych połączonych usług otrzymasz QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE .
Raportowanie Nazwa pola metrics.sk_ad_network_conversion_value została zmieniona na metrics.sk_ad_network_fine_conversion_value