Versionsverwaltung

Semantische Versionsverwaltung

Die Google Ads API folgt der semantischen Versionsverwaltung. eine Dur- und eine Moll-Version. Das Format der Version ist MAJOR.MINOR oder vMAJOR_MINOR. Zum Beispiel ist v17_0 eine Hauptversion, während v17_1 ist 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 mit dem Format vX_0 enden, wobei X die Hauptversion ist. Versionsnummer.

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

https://googleads.googleapis.com/vX

Wenn Sie ein Upgrade von einer älteren Hauptversion ausführen, ist für Ihren Code möglicherweise ändert sich, wenn Sie zum neuen Hauptversionsendpunkt wechseln. Wenn Sie unser Clientbibliotheken und führen Sie dann ein Upgrade auf die neueste Version durch. Sobald eine Hauptversion veröffentlicht wird, stellen wir eine Migrationsanleitung zur Verfügung, sollten Sie alle funktionsgefährdenden Änderungen in Ihrem Code korrigieren.

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 0 zu -- als Standardwert
• Änderung der zurückgegebenen Fehlerursache von A nach B.

Nebenversionen

Nebenversionen führen nur abwärtskompatible Änderungen ein. Bei einer Nebenversion „vMAJOR_MINOR“ hätte eine MINOR-Zahl, die größer als null ist.

Wenn eine Nebenversion veröffentlicht wird, wird der bereits verwendete Endpunkt automatisch aktualisiert werden. Ihr Code wird dadurch nicht beschädigt. Sie können Ihre vorhandenen Clientbibliotheken weiter zu verwenden.

Nebenversionen enthalten neue Funktionen oder Updates, die sich nicht auf Ihre vorhandenem Code. Wenn Sie diese neuen Funktionen nutzen möchten, Clientbibliotheken auf die neueste Version aktualisieren.

Sonnenuntergänge

Ältere Versionen der Google Ads API müssen in regelmäßigen Abständen eingestellt werden. Wir veröffentlichen Hinweise im Entwicklerblog wenn eine Version bald abläuft. Die Der Zeitplan für die Einstellung wurde mit dem zukünftigen Ablauf aktualisiert. Daten.