Von Zeit zu Zeit kann es sinnvoll sein, ein Upgrade von einer älteren Hauptversion auf eine neuere Hauptversion durchzuführen. Das kann daran liegen, dass eine Version eingestellt wird, oder daran, dass Sie eine neue Funktion verwenden möchten. Wir empfehlen, immer ein Upgrade auf die neueste Version durchzuführen.
Informationen zur Planung Ihrer Upgrades finden Sie in unserem Zeitplan für die Einstellung. Weitere Informationen zur Versionsverwaltung finden Sie in unserem Leitfaden zur Versionsverwaltung.
Die folgende Checkliste soll Ihnen den Einstieg in den Upgradeprozess erleichtern:
- Der Endpunkt ändert sich, wenn die Hauptversion geändert wird. Aktualisieren Sie Ihre Clientbibliotheken, um den neuesten Endpunkt zu verwenden.
- Lesen Sie die Versionshinweise, um die Änderungen zu sehen, die in den einzelnen Releases eingeführt wurden.
- In den folgenden Tabellen sehen Sie die Bereiche, auf die Sie sich für die Version konzentrieren sollten, auf die Sie ein Upgrade ausführen.
Eine umfassende Übersicht der Änderungen, die auf einem Unterschied zwischen den Protos der beiden Versionen basieren, finden Sie in der diff-Tabelle.
v16 bis v17
| Änderungen an Diensten und ihren Komponenten | |
|---|---|
GoogleAdsService
Search- und SearchStream-Anfragen |
Wenn Ihre Anfrage gedrosselt wird, weil sie zu teuer ist, wird entweder |
GoogleAdsService
Search-Anfragen |
Die Übergabe von |
Campaign und Ad |
Kampagnen mit dem Außerdem ändern sich bei einigen Anzeigen Typ und Feldnamen für die Berichterstellung:
|
AdService |
Der Endpunkt GetAd wird entfernt. Dadurch entspricht der AdService den anderen Diensten in der Google Ads API. In unserem Leitfaden zum Abrufen von Objekten finden Sie eine empfohlene Methode zum Abrufen von Anzeigen und anderen Ressourcentypen. |
CustomerLifecycleGoal
und CampaignLifecycleGoal |
Die Verwaltung von Segmenten für Zielvorhaben vom Typ „Lebenszyklus“ wurde überarbeitet. Eine vollständige Übersicht finden Sie in der Dokumentation zu Lebenszykluszielen im Abschnitt Zielgruppen segmentieren. |
ProductLink |
Wenn Sie eine GoogleAdsService-Such- oder Suchstreamanfrage für product_link ausführen, können Sie jetzt nur Felder auswählen, die sich auf ein verknüpftes Produkt beziehen. Die Auswahl mehrerer Felder aus verschiedenen verknüpften Produkten führt zum Fehler QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. |
| Berichterstellung | Das Feld metrics.sk_ad_network_conversion_value wurde in metrics.sk_ad_network_fine_conversion_value umbenannt. |
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 eine vorhandene CampaignLifecycleGoal zuvor aktualisieren, würden Sie einen create-Vorgang mit bestimmten Anforderungen ausführen.
Jetzt können Sie stattdessen einen update-Vorgang wie bei anderen Ressourcentypen ausführen. |
| Error Reporting | Zwei Fälle, in denen der allgemeine Fehler ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT zurückgegeben wurde, führen jetzt zu genaueren Fehlermeldungen:
|
AudienceInsightsAttributeMetadata |
Das Feld „score“ wurde entfernt. |
KeywordMatchTypeRecommendation |
Wenn die Keyword-Option nicht festgelegt ist, gibt die API für das Feld recommended_match_type jetzt UNSPECIFIED anstelle von UNKNOWN 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.
Unten sehen Sie die ImageAdInfo-Änderung.
|
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
|
Durch
ProductCategoryConstant ersetzt.
Mehrere Felder wurden entsprechend umbenannt, siehe die nächsten drei Änderungen unten.
|
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:
|
Campaign.shopping_setting
|
Dieses Feld kann nicht mehr zum Erstellen von Suchkampagnen verwendet werden. |
CampaignCriterion.listing_scope
|
Dieses Feld kann nicht mehr zum Erstellen von Suchkampagnen verwendet werden. |
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 der obersten Ebene verschoben, die Sie separat abfragen können.
Ändern Sie Ihre Abfrage von: SELECT customer.offline_conversion_client_summaries FROM customeran: 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 Mit dem Query Builder können Sie die Liste der verfügbaren Felder zum Auswählen und Filtern untersuchen. |
OfflineConversionUploadAlert
|
Umbenannt in
OfflineConversionAlert. |
OfflineConversionUploadError
|
Umbenannt in
OfflineConversionError. |
AdNetworkType
|
Die Enums
YOUTUBE_SEARCH und
YOUTUBE_WATCH wurden zu einer einzigen Aufzählung zusammengeführt:
YOUTUBE.
|