Versionsverwaltung

Semantische Versionsverwaltung

Die Google Ads API folgt der semantischen Versionsverwaltung mit einer Haupt- und einer Nebenversion. Das Format der Version ist MAJOR.MINOR oder vMAJOR_MINOR. Beispielsweise ist v16_0 eine Hauptversion und v16_1 eine Nebenversion.

Frühere Versionen finden Sie in den Versionshinweisen.

Hauptversionen

Haupt-Release-Versionen führen einige nicht abwärtskompatible Änderungen ein. Die Version endet mit null und hat das Format vX_0, wobei X die Hauptversionsnummer ist.

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

https://googleads.googleapis.com/vX

Wenn Sie ein Upgrade von einer älteren Hauptversion durchführen, erfordert Ihr Code möglicherweise Änderungen, wenn Sie zum neuen Hauptversionsendpunkt wechseln. Wenn Sie unsere Clientbibliotheken verwenden, führen Sie ein Upgrade auf die neueste Version durch. Wenn eine Hauptversion veröffentlicht wird, erhalten Sie eine Migrationsanleitung, 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
  • Ändern des Formats eines Ressourcennamens.
  • Ändern des URL-Formats in der HTTP-Definition.
  • Ausgabeformate ändern, z. B. von 0 zu -- als Standardwert ändern
  • Änderung der zurückgegebenen Fehlerursache von A in B

Nebenversionen

Nebenversionen enthalten nur abwärtskompatible Änderungen. Bei einer Nebenversion hätte vMAJOR_MINOR eine MINOR-Zahl, die größer als null ist.

Wenn eine Nebenversion freigegeben wird, wird der bereits verwendete Endpunkt automatisch aktualisiert. Dies führt nicht dazu, dass Ihr Code beschädigt wird. 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 durch.

Sonnenuntergänge

Ältere Versionen der Google Ads API müssen in regelmäßigen Abständen eingestellt werden. Wir werden Hinweise im Entwicklerblog veröffentlichen, wenn eine Version bald eingestellt wird. Der Zeitplan für die Einstellung wird entsprechend aktualisiert.