Wenn Sie sich mit anderen Nutzern über unsere Produkte austauschen und Feedback geben möchten, können Sie dem offiziellen Google Ads-Discord-Kanal auf dem Server der Google Advertising and Measurement Community beitreten.

Diese Seite wurde von der Cloud Translation API übersetzt.

Versionsverwaltung

Semantische Versionierung

Die Google Ads API folgt der semantischen Versionsverwaltung, bei der es eine Haupt- und eine Nebenversion gibt. Das Format der Version ist MAJOR.MINOR oder vMAJOR_MINOR. v21_0 ist beispielsweise eine Hauptversion, während v21_1 eine Nebenversion ist.

Versionshinweise für frühere Versionen

Hauptversionen

Hauptversionen führen zu einigen nicht abwärtskompatiblen Änderungen. Die Version würde mit null enden und das Format vX_0 haben, wobei X die Hauptversionsnummer ist.

Jede Hauptversion hat einen separaten Endpunkt. In dieser Beispiel-URL ist X die Hauptversionsnummer.

https://googleads.googleapis.com/vX

Wenn Sie ein Upgrade von einer älteren Hauptversion durchführen, muss Ihr Code möglicherweise geändert werden, wenn Sie zum Endpunkt der neuen Hauptversion wechseln. Wenn Sie unsere Clientbibliotheken verwenden, aktualisieren Sie sie auf die neueste Version. Wenn eine Hauptversion veröffentlicht wird, stellen wir einen Migrationsleitfaden zur Verfügung, den Sie durchgehen sollten, um alle wichtigen Änderungen in Ihrem Code zu beheben.

Beispiele für nicht abwärtskompatible Änderungen:

Entfernen oder Umbenennen eines Dienstes, einer Schnittstelle, eines Felds, einer Methode oder eines Enum-Werts.
Den Typ eines Felds ändern.
Das Format des Ressourcennamens ändern
Das URL-Format in der HTTP-Definition ändern
Änderung von Ausgabeformaten, z. B. von 0 zu -- als Standardwert.
Der von A zurückgegebene Fehlergrund wird in B geändert.

Nebenversionen

Nebenversionen führen nur zu abwärtskompatiblen Änderungen. Bei einer Nebenversion hat vMAJOR_MINOR eine MINOR-Nummer größer als null.

Wenn eine Nebenversion veröffentlicht wird, wird der bereits verwendete Endpunkt automatisch aktualisiert. Dadurch wird Ihr Code nicht beschädigt. Sie können Ihre vorhandenen Clientbibliotheken weiterhin verwenden.

Nebenversionen enthalten neue Funktionen oder Updates, die sich nicht auf Ihren vorhandenen Code auswirken. Wenn Sie diese neuen Funktionen nutzen möchten, müssen Sie Ihre Clientbibliotheken auf die neueste Version aktualisieren.

Sonnenuntergänge

Ältere Google Ads API-Versionen müssen regelmäßig eingestellt werden. Wir veröffentlichen Benachrichtigungen im Entwicklerblog, wenn eine Version eingestellt wird. Der Zeitplan für die Einstellung wird mit zukünftigen Einstellungsdaten aktualisiert.