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 es immer null, bei Nebenversionen immer größer als null.
Hauptversionen
Hauptversionen führen zu funktionsgefährdenden Änderungen, 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 auf die neueste Version aktualisieren. 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:
- Dienst, Schnittstelle, Feld, Methode oder Enum-Wert entfernen oder umbenennen
- Den Typ eines Felds ändern
- Das Format des Ressourcennamens ändern
- Das 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 Ihre vorhandene Clientbibliothek weiterhin 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 Ihre Clientbibliothek auf die neueste Version aktualisieren.
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.