Die Search Ads 360 Reporting API verwendet semantisches Versionskontrollsystem.
Es gibt Haupt- und Nebenversionen, die als vMAJOR_MINOR formatiert sind. Beispiel: v0_0 ist die erste Hauptversion und v0_1 die erste Nebenversion. Das Suffix der Versionsnummer gibt den Versionstyp an: Bei Hauptversionen ist er immer null und bei Nebenversionen immer größer als null.
Hauptversionen
Hauptversionen führen funktionsgefährdende Änderungen mit sich, d. h. Änderungen, die nicht abwärtskompatibel sind.
Jede Hauptversion hat einen separaten Endpunkt, z. B.:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
Wenn Sie von einer Hauptversion auf eine andere umstellen, müssen Sie möglicherweise Ihren Code ändern, bevor Sie zum Endpunkt der neuen Hauptversion wechseln.
Wenn Sie eine Clientbibliothek verwenden, müssen Sie ein Upgrade auf die neueste Version durchführen. Neue Hauptversionen enthalten einen Migrationsleitfaden, mit dem Sie alle funktionsgefährdenden Änderungen in Ihrem Code beheben können.
Beispiele für nicht abwärtskompatible Änderungen:
- Entfernen oder Umbenennen eines Dienstes, einer Schnittstelle, eines Felds, einer Methode oder eines ENUM-Werts
- Den Typ eines Felds ändern
- Das Format des Ressourcennamens ändern
- URL-Format in der HTTP-Definition ändern
- Ausgabeformate ändern, z. B.
0in--als Standardwert ändern - Der zurückgegebene Fehlergrund wird von A in B geändert.
Nebenversionen
Nebenversionen führen nur zu abwärtskompatiblen Änderungen.
Wenn eine Nebenversion veröffentlicht wird, wird der bereits verwendete Endpunkt automatisch aktualisiert. Dadurch wird Ihr Code nicht beschädigt. Sie können weiterhin Ihre vorhandene Clientbibliothek verwenden.
Nebenversionen enthalten neue Funktionen oder Updates, die sich nicht auf Ihren vorhandenen Code auswirken. Wenn Sie die neuen Funktionen verwenden möchten, müssen Sie ein Upgrade Ihrer Clientbibliothek auf die neueste Version durchführen.
Sonnenuntergänge
Wenn eine ältere Version der Search Ads 360 Reporting API eingestellt wird, veröffentlichen wir eine entsprechende Mitteilung in der Google-Gruppe searchads-api-announcements.