Diese Seite wurde von der Cloud Translation API übersetzt.

Upgrade auf die neueste Version

Sie sollten regelmäßig ein Upgrade von einer älteren Hauptversion der Google Ads API auf eine neuere Hauptversion durchführen. Es könnte daran liegen, dass eine Version eingestellt wird oder eine neue Funktion verwendet werden soll. Wir empfehlen, immer auf die neueste Version zu aktualisieren.

Sehen Sie sich unseren Zeitplan für Einstellungen an, um Ihre Upgrades zu planen. Weitere Informationen zur Funktionsweise der Versionsverwaltung finden Sie in unserem Leitfaden zur Versionsverwaltung.

Die folgende Checkliste soll Ihnen bei den ersten Schritten für das Upgrade helfen:

Der Endpunkt ändert sich, wenn Sie die Hauptversionen ändern. Aktualisieren Sie Ihre Clientbibliotheken, um den neuesten Endpunkt zu verwenden.
In den Versionshinweisen finden Sie die Änderungen, die in den einzelnen Releases eingeführt wurden.
In den folgenden Tabellen sind die Bereiche aufgeführt, auf die Sie sich bei der Version konzentrieren sollten, auf die Sie ein Upgrade ausführen.

Einen umfassenden Überblick über die Änderungen, die auf den Unterschieden zwischen den Protos aus den beiden Versionen basieren, finden Sie in der Diff-Tabelle.

v15 bis v16

Änderungen an Diensten und ihren Komponenten
`AccountLink`	Die Verknüpfungen `data_partner` und `google_ads` in `linked_account` wurden entfernt. Verwenden Sie stattdessen `ProductLinkService` und `ProductLinkInvitationService`.
`CampaignLifecycleGoal`	Wenn Sie zuvor ein vorhandenes `CampaignLifecycleGoal` aktualisieren, würden Sie einen `create`-Vorgang mit bestimmten Anforderungen ausführen. Jetzt können Sie stattdessen wie bei anderen Ressourcentypen einen `update`-Vorgang ausführen.
Error Reporting	In zwei Fällen, in denen der allgemeine Fehler `ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT` zurückgegeben wurde, erhalten Sie jetzt spezifischere Fehlermeldungen: `CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT` `CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS`
`AudienceInsightsAttributeMetadata`	Das Feld „`score`“ wurde entfernt.
`KeywordMatchTypeRecommendation`	Wenn keine Keyword-Option festgelegt wurde, gibt die API jetzt `UNSPECIFIED` anstelle von `UNKNOWN` für das Feld `recommended_match_type` zurück.

v14 bis v15

Änderungen an Diensten und ihren Komponenten
`AssetGroupListingGroupFilter`	Das Enum-Feld `vertical` wurde in `feed_type` umbenannt.
`MediaFileService`	Der Dienst wurde entfernt, da er nicht mehr benötigt wird. Die Änderung zu `ImageAdInfo` findest du unten.
`ImageAdInfo`	Das Feld `media_file` wurde durch `image_asset` ersetzt.
`MerchantCenterLinkService`	Der Dienst wurde durch `ProductLinkInvitationService` und `ProductLinkService` ersetzt.
`Campaign.ShoppingSetting`	Das Feld „`sales_country`“ wurde entfernt. Die Informationen werden jetzt im Feld `feed_label` zurückgegeben.
`ProductBiddingCategoryConstant`	Ersetzt durch `ProductCategoryConstant`. Mehrere Felder wurden entsprechend umbenannt. Unten sehen Sie die nächsten drei Änderungen.
`ListingDimensionInfo`	Das Feld `product_bidding_category` wurde durch `product_category` ersetzt.
`ListingGroupFilterDimension`	Das Feld `product_bidding_category` wurde durch `product_category` ersetzt.
`shopping_performance_view`-Bericht	Die folgenden Segmentfelder: `product_bidding_category_level1` `product_bidding_category_level2` `product_bidding_category_level3` `product_bidding_category_level4` `product_bidding_category_level5` wurden ersetzt durch: `product_category_level1` `product_category_level2` `product_category_level3` `product_category_level4` `product_category_level5`
`Campaign.shopping_setting`	Das Erstellen von Suchkampagnen mit diesem Feld ist nicht mehr möglich.
`CampaignCriterion.listing_scope`	Das Erstellen von Suchkampagnen mit diesem Feld ist nicht mehr möglich.
`sk_ad_network_conversions`-Bericht	`metrics.sk_ad_network_conversions` wurde durch `metrics.sk_ad_network_installs` ersetzt.
`OfflineConversionClientSummary`	Das Feld `offline_conversion_client_summaries` wurde von `Customer` in eine Ressource auf oberster Ebene verschoben, die Sie separat abfragen können. Ändern Sie Ihre Abfrage von: SELECT customer.offline_conversion_client_summaries FROM customer an: 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 Verwenden Sie den Query Builder, um die Liste der verfügbaren Felder zum Auswählen und Filtern zu erkunden.
`OfflineConversionUploadAlert`	Umbenannt in `OfflineConversionAlert`.
`OfflineConversionUploadError`	Umbenannt in `OfflineConversionError`.
`AdNetworkType`	Die Aufzählungen `YOUTUBE_SEARCH` und `YOUTUBE_WATCH` wurden zu einer einzigen Aufzählung zusammengeführt: `YOUTUBE`.