Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Änderungslog

In diesem Änderungsprotokoll sind wichtige Änderungen für die API-Designanleitung aufgeführt.

2021-04

  • Einführung der sichtbarkeitsbasierten Versionsverwaltung.

2021-03

  • Anmerkung für reine Ausgabefelder hinzugefügt.

  • Hinweise zur Aufzählung von Werten so, dass sie immer einen expliziten _UNSPECIFIED-Wert enthalten.

  • Fügen Sie Anleitungen zum Generieren und Parsen von Ressourcennamen hinzu.

  • progress_percent wurde zu Standardfeldern hinzugefügt.

2021-02

  • Für einfache Proto-Felder optional von proto3 wurde eine Anleitung hinzugefügt.

2021-01

  • Fehlerseite aktualisiert, um die neuesten Verbesserungen in Bezug auf google.rpc.ErrorInfo und google.api.ErrorReason zu berücksichtigen.

  • Es wurde eine Anleitung zur Verwendung von oauth2l, curl und Systemparametern zur Fehlerbehebung bei Google APIs hinzugefügt.

  • Der Erläuterung des Fehlercodes 502 wurde zur Seite "Fehler" hinzugefügt. Es handelt sich nicht um einen API-Fehler, sondern ein Netzwerkfehler.

2020-12

  • Paketnamen müssen für eine globale Konsistenz durch einen einzigen Komponentennamen angegeben werden. Paketnamen dürfen keine Unterstriche enthalten.

2020-09

  • Einige Anforderungen an Feldbeschreibungen wurden bereinigt. Die Verwendung von „muss“ außerhalb von RFC 2119 wurde zu „sollte“-Anweisungen in RFC 2119 geändert.

  • Das Standardfeld bool deleted wurde zugunsten von google.protobuf.Timestamp delete_time (bisher bereits aufgeführt) entfernt.

2020-07

  • Die Datei documentation.md wurde aktualisiert und entspricht https://google.aip.dev/192#formatting. Markdown-Tabellen und Raw-HTML dürfen in Proto-Kommentaren nicht verwendet werden.

  • ErrorInfo zur Fehlerbehandlung hinzugefügt.

  • Große Nutzlasten für Designmuster wurden hinzugefügt.

2020-04

  • Cloud-APIs wurden im Glossar in Google Cloud-APIs umbenannt.
  • API und Dienst wurden als Synonyme für API-Dienst eingeführt.

2020-02

  • Die Versionierung wurde aktualisiert, um zwei Versionsstrategien (auf Kanalebene und Releaseebene) hinzuzufügen, Anleitungen zu Punktversionen zu entfernen und die Bezugnahme auf die semantische Versionierung zu ändern.

2020-01

  • Datenaufbewahrung zu Entwurfsmuster wurden hinzugefügt.

2019-11

  • Terminologie-Cloud-APIs wurde zum Glossar hinzugefügt.
  • Clientsempfehlung zur Wiederholung nur bei nicht verfügbaren Fehlern wurden festgelegt.

2019-06

  • "Bool vs Enum vs String" wurde hinzugefügt, um Muster zu entwerfen.

2019-03

  • Standardfeldern wurden Systemparameter hinzugefügt

2019-02

  • Domainbereichsnamen wurden dem Designmustern hinzugefügt

2018-03

  • Halbgeschlossenes Streaming wurde den Designmustern hinzugefügt.

2018-02

  • read_time wurde zu Standardfeldern hinzugefügt.

2018-01

  • Schemareferenz für API-Dienstdefinition wurde hinzugefügt.

2017-12

  • Es wurde klargestellt, dass die API-Hauptversion die letzte Komponente des Proto-Paketnamens sein muss.

2017-11

  • Es wurde klargestellt, warum die Methode Create eine Eingaberessource verwendet.
  • Es wurde klargestellt, dass es Sammlungs-IDs gibt, die keine Pluralform haben, z. B. "Beweismittel" oder "Wetter".
  • Es wurden Singleton-Ressourcen zu Designmustern hinzugefügt.
  • Es wurden die C#-Namenskonventionen für Akronyme und Versionen geklärt.

2017-09

  • mime_type wurde zu Standardfeldern hinzugefügt.
  • expire_time wurde zu Standardfeldern hinzugefügt.
  • start_time und end_time wurden zu Standardfeldern hinzugefügt.

2017-02

  • "API-Endpunkt" wurde zum Glossar hinzugefügt.
  • update_mask wurde zu Standardfeldern hinzugefügt.
  • Link zu FieldMask wurde zu Standardmethoden hinzugefügt.
  • Es wurde darauf hingewiesen, dass die OpenAPI-Spezifikation keine Ganzzahlen ohne Vorzeichen unterstützt.
  • Es wurde klargestellt, dass Verben in Methodennamen im Imperativ verwendet werden müssen.