Versionsverwaltung

Semantische Versionierung

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

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

Hauptversionen

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

Jede Hauptversion hat einen separaten Endpunkt. Dies ist ein Beispiel für die URL, wobei X die Hauptversionsnummer ist.

https://googleads.googleapis.com/vX

Wenn Sie von einer älteren Hauptversion auf eine neue umstellen, müssen Sie möglicherweise Änderungen an Ihrem Code vornehmen. Wenn Sie unsere Clientbibliotheken verwenden, führen Sie ein Upgrade auf die neueste Version durch. Wenn eine neue Hauptversion veröffentlicht wird, stellen wir einen Migrationsleitfaden zur Verfügung, mit dem Sie alle nötigen Änderungen an Ihrem Code vornehmen können.

Beispiele für nicht abwärtskompatible Änderungen:

• Dienst, Schnittstelle, Feld, Methode oder Enum-Wert entfernen oder umbenennen
• Den Typ eines Felds ändern
• Das Format des Ressourcennamens ändern
• Das URL-Format in der HTTP-Definition ändern
• Ändern von Ausgabeformaten, z. B. von 0 in -- als Standardwert
• Der zurückgegebene Fehlergrund wird von A in B geändert.

Nebenversionen

Nebenversionen führen nur zu abwärtskompatiblen Änderungen. Bei einer Nebenversion ist MINOR für vMAJOR_MINOR größer als null.

Wenn eine Nebenversion veröffentlicht wird, wird der bereits verwendete Endpunkt automatisch aktualisiert. Dies führt nicht zu Fehlern im Code. 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 werden in regelmäßigen Abständen eingestellt. Wir veröffentlichen im Entwicklerblog entsprechende Hinweise, wenn eine Version eingestellt wird. Der Zeitplan für die Einstellung wird mit zukünftigen Auslaufdaten aktualisiert.