Semantische Versionierung
Die Google Ads API verwendet die semantische Versionsverwaltung mit einer Haupt- und einer Nebenversionsnummer. Versionen werden als MAJOR.MINOR oder vMAJOR.MINOR geschrieben.
v26.0 (oder v26) ist beispielsweise eine Hauptversion, während v26.1 eine Nebenversion ist.
Weitere Informationen zu aktuellen und früheren Versionen finden Sie in den Versionshinweisen.
Hauptversionen
Hauptversionen führen zu funktionsgefährdenden, nicht abwärtskompatiblen Änderungen. Die erste Veröffentlichung einer Hauptversion endet mit einer Null (vX.0 oder vX, wobei X die Hauptversionsnummer ist).
Jede Hauptversion hat einen separaten REST- und gRPC-Endpunktpfad (vX), der das Suffix der Nebenversion nicht enthält. In der folgenden URL ist X die Hauptversionsnummer (z. B. v26):
https://googleads.googleapis.com/vX
Wenn Sie ein Upgrade von einer älteren Hauptversion durchführen, müssen Sie möglicherweise Ihren Code ändern, wenn Sie zum neuen Hauptversionsendpunkt wechseln. Wenn Sie unsere Clientbibliotheken verwenden, führen Sie ein Upgrade auf die Clientbibliotheksversion durch, die die neue Hauptversion unterstützt. Wenn eine Hauptversion veröffentlicht wird, stellen wir einen Upgrade-Leitfaden zur Verfügung, mit dem Sie funktionsgefährdende Änderungen in Ihrem Code beheben können.
Beispiele für funktionsgefährdende Änderungen:
- Entfernen oder Umbenennen eines Dienstes, einer Schnittstelle, eines Felds, einer Methode oder eines Enum-Werts.
- Ändern des Typs eines Felds.
- Ändern des Formats eines Ressourcennamens.
- Ändern des URL-Formats in der HTTP-Definition.
- Ausgabeformate ändern, z. B. Standardwerte ändern
- Der zurückgegebene Fehlergrund wird von A in B geändert.
Nebenversionen
Nebenversionen führen nur abwärtskompatible Änderungen ein. Bei einer Nebenversion hat vMAJOR.MINOR eine MINOR-Nummer, die größer als null ist (z. B. v26.1).
Wenn eine Nebenversion veröffentlicht wird, wird der vorhandene Endpunkt der Hauptversion (https://googleads.googleapis.com/vX) automatisch aktualisiert. Sie müssen den Versionspfad in Ihren Endpunkt-URLs nicht ändern und vorhandener Code funktioniert weiterhin ohne Unterbrechung.
In Nebenversionen werden Funktionen oder Updates hinzugefügt, die sich nicht auf Ihren vorhandenen Code auswirken. Wenn Sie Felder oder Funktionen aus einer Nebenversion mit einer Clientbibliothek verwenden möchten, aktualisieren Sie Ihre Clientbibliothek auf eine Version, die die Definitionen der Nebenversion enthält.
Einstellung und Außerbetriebnahme
Ältere Versionen der Google Ads API werden regelmäßig eingestellt und später deaktiviert:
- Verworfen: Wenn eine Hauptversion (z. B.
v26) veröffentlicht wird, werden alle früheren Hauptversionen als verworfen markiert. API-Aufrufe an verworfene Versionen sind bis zum Datum der Einstellung weiterhin erfolgreich und werden von vorhandenen Clientbibliotheksreleases weiterhin unterstützt. Nachfolgende Clientbibliotheksreleases lassen jedoch verworfene API-Versionen aus, um die Paketgröße zu reduzieren. - Einstellung: Eine Version wird am Datum der Einstellung deaktiviert und alle API-Aufrufe an ihren Endpunkt schlagen fehl.
Wir veröffentlichen Ankündigungen im Entwicklerblog, bevor Versionen eingestellt werden. Im Zeitplan für die Einstellung und Deaktivierung finden Sie Informationen zu aktiven, eingestellten und geplanten Deaktivierungsdaten.