Semantische Versionsverwaltung
Für die Google Ads API gilt die semantische Versionierung einer Haupt- und einer Nebenversion. Das Format der Version ist MAJOR.MINOR oder vMAJOR_MINOR. Beispielsweise ist v13_0 eine Hauptversion, während v13_1 eine Nebenversion ist.
Informationen zu früheren Versionen finden Sie in den Versionshinweisen.
Hauptversionen
In den Hauptversionen wurden einige nicht abwärtskompatible Änderungen vorgenommen.
Die Version endet mit Null im Format vX_0, wobei X die Hauptversionsnummer ist.
Jede Hauptversion hat einen separaten Endpunkt. In diesem Beispiel ist X die Hauptversionsnummer.
https://googleads.googleapis.com/vX
Wenn Sie ein Upgrade von einer älteren Hauptversion durchführen, müssen Sie möglicherweise Änderungen am Code vornehmen, wenn Sie zum neuen Hauptversionsendpunkt wechseln. Wenn Sie unsere Clientbibliotheken verwenden, führen Sie ein Upgrade auf die neueste Version aus. Wenn eine Hauptversion veröffentlicht wird, stellen wir einen Migrationsleitfaden zur Verfügung, mit dem Sie wichtige Änderungen in Ihrem Code beheben können.
Beispiele für nicht abwärtskompatible Änderungen:
- Dienst, Schnittstelle, Feld, Methode oder Enum-Wert entfernen oder umbenennen
- Den Feldtyp ändern
- Format eines Ressourcennamens ändern.
- URL-Format in der HTTP-Definition ändern
- Ausgabeformate ändern, z. B. von
0zu--als Standardwert. - Ändern des zurückgegebenen Fehlergrunds von A zu B.
Nebenversionen
Nebenversionen führen nur rückwärtskompatible Änderungen ein. Bei einer Nebenversion hätte vMAJOR_MINOR eine MINOR-Nummer, die größer als null ist.
Wenn eine Nebenversion veröffentlicht wird, wird der bereits verwendete Endpunkt automatisch aktualisiert. Dadurch wird der 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 Features verwenden möchten, führen Sie ein Upgrade Ihrer Clientbibliotheken auf die neueste Version aus.
Sonnenuntergänge
Ältere Google Ads API-Versionen müssen von Zeit zu Zeit eingestellt werden. Benachrichtigungen werden im Entwicklerblog veröffentlicht, wenn eine Version bald eingestellt wird. Der Zeitplan für die Einstellung wird mit zukünftigen Ablaufdaten aktualisiert.