Log delle modifiche

Questo log delle modifiche evidenzia le modifiche importanti Guida alla progettazione delle API.

2021-12

• Terminologia modificata da API Networked a API Network per coerenza con https://google.aip.dev/9.

2021-09

• Documenta sia il formato di errore dell'API Google v1 sia quello v2.

2021-04

• È stata introdotta la gestione delle versioni in base alla visibilità.

• È stato introdotto il titolo dell'API nel glossario.

2021-03

• È stata aggiunta un'annotazione per i campi solo di output.

• Aggiorna le indicazioni per i valori dell'enum in modo da includere sempre un valore _UNSPECIFIED esplicito.

• Aggiungi indicazioni su come generare e analizzare i nomi delle risorse.

• Aggiungi progress_percent ai campi standard.

2021-02

• Sono state aggiunte indicazioni sui campi primitivi optional proto3.

2021-01

• È stata aggiornata la pagina Errori per includere l'ultimo miglioramento relativo a google.rpc.ErrorInfo e google.api.ErrorReason.

• Sono state aggiunte indicazioni su come utilizzare oauth2l, curl e i parametri di sistema per risolvere i problemi relativi agli errori con le API Google.

• È stata aggiunta la spiegazione del codice di errore 502 alla pagina Errori. Si tratta di una rete anziché un errore dell'API.

2020-12

• Per la coerenza globale, nei nomi dei pacchetti è necessario utilizzare i nomi dei componenti singoli. I nomi dei pacchetti non devono contenere trattini bassi.

2020-09

• Sono stati semplificati alcuni requisiti per le descrizioni dei campi. Sono stati modificati alcuni utilizzi di "deve" al di fuori del documento RFC 2119 in modo che siano conformi alle direttive "deve" del documento RFC 2119.

• Rimosso il campo standard bool deleted a favore di google.protobuf.Timestamp delete_time (già presente nell'elenco).

2020-07

• È stata aggiornata la documentazione.md in modo che corrisponda a https://google.aip.dev/192#formatting. Le tabelle Markdown e il codice HTML non elaborato non devono essere utilizzati nei commenti proto.

• È stato aggiunto ErrorInfo per la gestione degli errori.

• Sono stati aggiunti payload di grandi dimensioni per i pattern di progettazione.

2020-04

• API Cloud rinominate in API Google Cloud nel glossario.
• API e servizio introdotti come sinonimi di servizio API.

2020-02

• È stato aggiornato il sistema di versionamento per aggiungere due strategie di versionamento (basate su canale e su release), rimuovere le indicazioni sulle versioni point e modificare il modo in cui facciamo riferimento al versionamento semantico.

2020-01

• Aggiungi la conservazione dei dati per progettare pattern.

2019-11

• Aggiungi la terminologia delle API Cloud al glossario.
• Consiglia ai client di riprovare solo in caso di errori UNAVAILABLE.

2019-06

• Aggiungi "Bool, Enum e String" per progettare modelli.

2019-03

• Aggiungi parametri di sistema ai campi standard.

2019-02

• Aggiungi nomi con ambito di dominio per progettare pattern.

2018-03

• Aggiungi una semantica a metà chiusura dei flussi di dati per progettare i pattern.

2018-02

• Aggiungi read_time ai campi standard.

2018-01

• Aggiungi il riferimento allo schema per la definizione del servizio API.

2017-12

• Chiarisci che la versione principale dell'API deve essere l'ultimo componente del nome del pacchetto proto.

2017-11

• Chiarisci perché il metodo Create accetta una risorsa di input.
• Chiarisci gli ID raccolta che non hanno forma plurale, ad esempio prove e meteo.
• Aggiungi una risorsa singleton per progettare pattern.
• Chiarire le convenzioni di denominazione C# per acronimi e versioni.

2017-09

• Aggiungi mime_type ai campi standard.
• Aggiungi expire_time ai campi standard.
• Aggiungi start_time e end_time ai campi standard.

2017-02

• Aggiungi "Endpoint API" al glossario.
• Aggiungi update_mask ai campi standard.
• Aggiungi un link a FieldMask per i metodi standard.
• Indica che la specifica OpenAPI non supporta i numeri interi senza segno.
• Chiarisci che i nomi dei metodi devono utilizzare i verbi al modo imperativo.