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. v25_0 ist beispielsweise eine Hauptversion, während v25_1 eine Nebenversion ist.
Versionshinweise 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 ein Upgrade von einer älteren Hauptversion durchführen, müssen Sie möglicherweise Änderungen an Ihrem Code vornehmen, wenn Sie zum neuen Endpunkt der Hauptversion wechseln. Wenn Sie unsere Clientbibliothekenverwenden, führen Sie ein Upgrade auf die neueste Version durch. 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
0zu--als Standardwert - Den Fehlergrund von A zu B ändern
Nebenversionen
Nebenversionen führen nur zu abwärtskompatiblen Änderungen. Bei einer Nebenversion hat
vMAJOR_MINOR eine MINOR 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 weiterhin Ihre vorhandenen Clientbibliotheken verwenden.
Nebenversionen enthalten neue Funktionen oder Updates, die sich nicht auf Ihren vorhandenen Code auswirken. Wenn Sie diese neuen Funktionen verwenden möchten, führen Sie ein Upgrade Ihrer Clientbibliotheken auf die neueste Version durch.
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.