Versionsverwaltung in der Search Ads 360 Reporting API

Die Search Ads 360 Reporting API verwendet die semantische Versionsverwaltung.

Es gibt Haupt- und Nebenversionen im Format vMAJOR_MINOR v0_0 ist beispielsweise der Wert erste Hauptversion und v0_1 die erste Nebenversion. Das Suffix des Versionsnummer gibt den Versionstyp an: Bei Hauptversionen ist sie immer null, Bei Nebenversionen ist sie immer größer als null.

Hauptversionen

Hauptversionen führen zu funktionsgefährdenden Änderungen, d. h. Änderungen, die nicht abwärtskompatibel sein.

Jede Hauptversion hat einen separaten Endpunkt, zum Beispiel:

https://searchads360.googleapis.com/v0

https://searchads360.googleapis.com/v1

Wenn Sie ein Upgrade von einer Hauptversion auf eine andere durchführen, bevor Sie zum neuen Hauptversionsendpunkt wechseln.

Wenn Sie eine Clientbibliothek verwenden, müssen Sie ein Upgrade auf die neueste Version durchführen. Neue Hauptversionen bieten eine Migrationsanleitung, die Ihnen dabei hilft, 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. Ändern von 0 in -- als Standardwert
  • Änderung der zurückgegebenen Fehlerursache von A nach B.

Nebenversionen

Nebenversionen enthalten nur abwärtskompatible Änderungen.

Wenn eine Nebenversion veröffentlicht wird, ist der bereits verwendete Endpunkt automatisch aktualisiert werden. Dadurch wird Ihr Code nicht beschädigt. Du kannst fortfahren um Ihre vorhandene Clientbibliothek zu verwenden.

Nebenversionen enthalten neue Funktionen oder Updates, die sich nicht auf bestehende Code. Wenn Sie die neuen Funktionen nutzen möchten, müssen Sie Ihr Clientbibliothek auf die neueste Version.

Sonnenuntergänge

Wenn eine ältere Search Ads 360 Reporting API-Version eingestellt wird, Veröffentlichung einer Mitteilung in der Google-Gruppe searchads-api-announcements