Registro modifiche

Questo log delle modifiche evidenzia le modifiche significative alla guida alla progettazione di API.

2025-06

• Reindirizzamento della convenzione di denominazione della pagina Progettazione a Google AIP.

2024-10

• Reindirizzamento delle pagine di progettazione alle API di Google, ad eccezione di Struttura della directory e Convenzioni di denominazione.

2021-12

• Modifica della terminologia API di rete in API di rete per coerenza con https://google.aip.dev/9.

2021-09

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

2021-04

• È stato introdotto il controllo delle versioni basato sulla visibilità.

• È stato aggiunto il titolo dell'API al glossario.

2021-03

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

• Aggiorna le indicazioni sul valore 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 di 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 gli errori relativi alle API di Google.

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

2020-12

• I nomi dei pacchetti devono utilizzare nomi di componenti singolari per garantire la coerenza globale. I nomi dei pacchetti non devono utilizzare trattini bassi.

2020-09

• Sono stati puliti alcuni requisiti di descrizione dei campi; alcuni utilizzi di "deve" al di fuori di RFC 2119 sono stati modificati in direttive "should" di RFC 2119.

• È stato rimosso il campo standard bool deleted a favore di google.protobuf.Timestamp delete_time (che era già presente nell'elenco).

2020-07

• Aggiornamento di documentation.md in modo che corrisponda a https://google.aip.dev/192#formatting. Le tabelle Markdown e l'HTML non elaborato non devono essere utilizzati nei commenti proto.

• Aggiunta di ErrorInfo per la gestione degli errori.

• Aggiunta di payload di grandi dimensioni per i pattern di progettazione.

2020-04

• È stato rinominato Cloud API in API Google Cloud nel glossario.
• Sono stati introdotti API e servizio come sinonimi di servizio API.

2020-02

• È stato aggiornato il controllo delle versioni per aggiungere due strategie (basata sul canale e basata sulle release), rimuovere le indicazioni sulle versioni secondarie e modificare il modo in cui ci riferiamo al controllo delle versioni semantico.

2020-01

• Aggiungi la conservazione dei dati ai pattern di progettazione.

2019-11

• Aggiungi le API Cloud terminologiche al glossario.
• Consiglia ai clienti di riprovare solo in caso di errori UNAVAILABLE.

2019-06

• Aggiungi "Bool vs Enum vs String" ai pattern di progettazione.

2019-03

• Aggiungi parametri di sistema ai campi standard.

2019-02

• Aggiungi nomi con ambito di dominio ai pattern di progettazione.

2018-03

• Aggiungi la semantica di chiusura parziale dello streaming ai pattern di progettazione.

2018-02

• Aggiungi read_time ai campi standard.

2018-01

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

2017-12

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

2017-11

• Spiega perché il metodo Create accetta una risorsa di input.
• Chiarisci gli ID raccolta che non hanno la forma plurale, come prove e meteo.
• Aggiungi una risorsa singleton ai pattern di progettazione.
• Chiarisci 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 ai metodi standard.
• Menziona che la specifica OpenAPI non supporta i numeri interi senza segno.
• Chiariamo che i nomi dei metodi devono utilizzare verbi all'imperativo.