Upgrade auf die neueste Version

Es kann sinnvoll sein, von einer älteren Hauptversion der Google Ads API auf eine neuere Hauptversion umzustellen. Es könnte daran liegen, dass eine Version Oder Sie möchten eine neue Funktion verwenden. Wir empfehlen Ihnen, immer ein Upgrade auf die neueste Version durchzuführen.

Orientieren Sie sich an unserem Zeitplan für die Einstellung, Upgrades. Weitere Informationen finden Sie in unserem Leitfaden zur Versionsverwaltung. die Versionsverwaltung funktioniert.

Die folgende Checkliste soll Ihnen den Einstieg in den Upgradeprozess erleichtern:

  1. Der Endpunkt ändert sich, wenn die Hauptversion geändert wird. Aktualisieren Sie Ihre Clientbibliotheken, um den neuesten Endpunkt zu verwenden.
  2. Lesen Sie die Versionshinweise, um zu sehen, welche Änderungen eingeführt.
  3. In den folgenden Tabellen finden Sie Bereiche, auf die Sie sich bei der Version konzentrieren sollten, auf die Sie ein Upgrade durchführen.

Eine umfassende Übersicht über die Änderungen basierend auf einem Vergleich der Prototypdateien der beiden Versionen finden Sie in der Diff-Tabelle.

Version 17 auf Version 18

Änderungen an Diensten und ihren Komponenten
GoogleAdsService Search- und SearchStream-Anfragen

Wenn Ihre Anfrage gedrosselt wird, weil sie zu teuer ist, wird stattdessen QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION oder QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION statt QuotaError.RESOURCE_EXHAUSTED zurückgegeben. Blog ansehen Post.
GoogleAdsService Die summary_row_setting und return_total_results_count Felder in SearchGoogleAdsRequest sind jetzt Teil des neuen SearchSettings-Objekts.
AssetType Der enum-Wert DISCOVERY_CAROUSEL_CARD wurde umbenannt in DEMAND_GEN_CAROUSEL_CARD. Dies entspricht einer früheren Änderung, bei der Discovery-Kampagnen in Demand Gen-Kampagnen umbenannt wurden.
AudienceInsightsService.GenerateSuggestedTargetingInsights audience, baseline_audience und data_month Felder wurden innerhalb von verschoben: audience_definition.
DemandGenCampaignSettings Der Standardwert für das Feld upgraded_targeting ist jetzt true statt false.
LocalServicesLeadConversation Das Feld „phone_call_details.call_recording_url“ wird nicht mehr für statische Aufrufe ausgefüllt werden.

V16 auf V17

Änderungen an Diensten und ihren Komponenten
GoogleAdsService Search- und SearchStream-Anfragen

Ihre Anfrage kann gedrosselt werden, wenn sie zu teuer ist. Ist dies der Fall, erhalten Sie den Fehler QuotaError.RESOURCE_EXHAUSTED. Weitere Informationen finden Sie im Blogpost.
GoogleAdsService Search-Anfragen.

Wenn Sie eine page_size an GoogleAdsService.Search übergeben, wird ein RequestError.PAGE_SIZE_NOT_SUPPORTED-Fehler ausgegeben.
Campaign und Ad

Kampagnen mit einer AdvertisingChannelType von DISCOVERY haben jetzt eine AdvertisingChannelType von DEMAND_GEN.

Außerdem ändern sich bei einigen Anzeigen die Typ- und Feldnamen für Berichte:

  • DISCOVERY_MULTI_ASSET_ADD wird zu DEMAND_GEN_MULTI_ASSET_ADD und das entsprechende Berichtsfeld ad_group_ad.ad.discovery_multi_asset_ad wird zu ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD wird zu DEMAND_GEN_CAROUSEL_AD und das entsprechende Berichtsfeld ad_group_ad.ad.discovery_carousel_ad wird zu ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD wird zu DEMAND_GEN_VIDEO_RESPONSIVE_AD und das entsprechende Berichtsfeld ad_group_ad.ad.discovery_video_responsive_ad zu ad_group_ad.ad.demand_gen_video_responsive_ad.
AdService Der GetAd-Endpunkt wird entfernt. Dadurch wird die AdService in Übereinstimmung mit anderen Diensten in der Google Ads API. Weitere Informationen finden Sie in der Anleitung zum Abrufen -Objekten für die empfohlene Methode zum Abrufen von Anzeigen und anderen Ressourcentypen.
CustomerLifecycleGoal und CampaignLifecycleGoal Die Verwaltung von Segmenten für Zielvorhaben des Lebenszyklus wurde überarbeitet. Eine vollständige Übersicht finden Sie im Abschnitt Zielgruppen segmentieren der Dokumentation zu Zielvorhaben des Lebenszyklus.
ProductLink Beim Ausführen einer GoogleAdsService-Suche oder eines Suchstreams für product_link anfordern, können Sie jetzt nur noch Felder auswählen, die mit mit einem verknüpften Produkt verknüpft ist. Mehrere Felder aus verschiedenen verknüpften Produkten auswählen führt zu einer QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Fehler.
Berichte Das Feld metrics.sk_ad_network_conversion_value wurde in metrics.sk_ad_network_fine_conversion_value umbenannt.