Versionsverwaltung

Semantische Versionierung

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

In den Versionshinweisen finden Sie Informationen zu früheren Versionen.

Hauptversionen

Hauptversionen führen zu einigen nicht abwärtskompatiblen Änderungen. Die Version endet mit einer Null im Format vX_0, wobei X die Haupt versionsnummer ist.

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

https://googleads.googleapis.com/vX

Wenn Sie von einer älteren Hauptversion aktualisieren, muss Ihr Code möglicherweise geändert werden, wenn Sie zum neuen Endpunkt der 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 nicht abwärtskompatiblen Änderungen in Ihrem Code zu beheben.

Beispiele für nicht abwärtskompatible Änderungen:

Dienst, Schnittstelle, Feld, Methode oder Enum-Wert entfernen oder umbenennen
Den Typ eines Feldes ändern
Das Format des Ressourcennamens ändern
Das URL-Format in der HTTP-Definition ändern
Ausgabeformate ändern, z. B. von 0 zu -- als Standardwert
Den Fehlergrund von A zu B ändern

Nebenversionen

Nebenversionen führen nur zu abwärtskompatiblen Änderungen. Bei einer Nebenversion, vMAJOR_MINOR hat 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 verwenden möchten, aktualisieren Sie Ihre Clientbibliotheken auf die neueste Version.

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 Terminen für die Einstellung aktualisiert.