Semantische Versionsverwaltung
Die Google Ads API folgt der semantischen Versionsverwaltung, bei der es eine Haupt- und eine Nebenversion gibt. Das Format der Version ist MAJOR.MINOR oder vMAJOR_MINOR. Beispielsweise ist v17_0 eine Hauptversion und v17_1 eine Nebenversion.
Informationen zu früheren Versionen finden Sie in den Versionshinweisen.
Hauptversionen
Hauptversionen enthalten einige funktionsgefährdende, abwärtsinkompatible Ä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 ein Upgrade von einer älteren Hauptversion ausführen, müssen Sie möglicherweise Änderungen an Ihrem Code vornehmen, wenn Sie zum Endpunkt der neuen Hauptversion wechseln. Wenn Sie unsere Clientbibliotheken verwenden, führen Sie ein Upgrade auf die neueste Version durch. Wenn eine Hauptversion veröffentlicht wird, stellen wir eine Migrationsanleitung zur Verfügung, die Sie durchgehen sollten, um funktionsgefährdende Änderungen in Ihrem Code zu beheben.
Beispiele für funktionsgefährdende Änderungen:
- Entfernen oder Umbenennen eines Dienstes, einer Schnittstelle, eines Felds, einer Methode oder eines ENUM-Werts
- Ändern des Feldtyps
- Das Format eines Ressourcennamens ändern.
- URL-Format in der HTTP-Definition ändern
- Ändern der Ausgabeformate, z. B. Änderung von
0zu--als Standardwert - Änderung der zurückgegebenen Fehlerursache von A nach B.
Nebenversionen
Nebenversionen führen nur abwärtskompatible Änderungen ein. Bei einer Nebenversion hätte vMAJOR_MINOR eine MINOR-Zahl, die größer als null ist.
Wenn eine Nebenversion veröffentlicht wird, wird der bereits verwendete Endpunkt automatisch aktualisiert. Ihr Code wird dadurch nicht beschädigt. Sie können Ihre vorhandenen Clientbibliotheken weiterhin verwenden.
Nebenversionen enthalten neue Funktionen oder Updates, die sich nicht auf den 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 Versionen der Google Ads API müssen in regelmäßigen Abständen eingestellt werden. Sobald eine Version bald eingestellt wird, veröffentlichen wir entsprechende Hinweise im Entwicklerblog. Der Zeitplan für die Einstellung wird mit dem Ablaufdatum aktualisiert.