Mengalihkan Konvensi Penamaan halaman Desain ke Google AIP.
2024-10
Mengalihkan halaman Desain ke AIP Google, kecuali untuk Struktur Direktori dan Konvensi Penamaan.
2021-12
Mengubah terminologi Networked API menjadi Network API agar konsisten dengan
https://google.aip.dev/9.
2021-09
Mendokumentasikan format error Google API v1 dan v2.
2021-04
Memperkenalkan pembuatan versi berbasis visibilitas.
Memperkenalkan judul API ke glosarium.
2021-03
Menambahkan anotasi untuk kolom hanya output.
Perbarui panduan nilai enum agar selalu menyertakan nilai _UNSPECIFIED eksplisit.
Menambahkan panduan tentang cara membuat dan mengurai nama resource.
Menambahkan progress_percent ke kolom standar.
2021-02
Menambahkan panduan tentang kolom primitif optional proto3.
2021-01
Memperbarui halaman Error untuk mencakup peningkatan terbaru terkait
google.rpc.ErrorInfo dan google.api.ErrorReason.
Menambahkan panduan tentang cara menggunakan oauth2l, curl, dan Parameter Sistem untuk memecahkan masalah error dengan Google API.
Menambahkan penjelasan kode error 502 ke halaman Error. Ini adalah error
jaringan, bukan error API.
2020-12
Nama paket harus menggunakan nama komponen tunggal untuk konsistensi global.
Nama paket tidak boleh menggunakan garis bawah.
2020-09
Membersihkan beberapa persyaratan deskripsi kolom; mengubah beberapa penggunaan "harus" di luar RFC 2119 menjadi arahan "sebaiknya" RFC 2119.
Menghapus kolom standar bool deleted, dan menggantinya dengan
google.protobuf.Timestamp delete_time (yang sudah tercantum).
2020-07
Memperbarui documentation.md agar sesuai dengan https://google.aip.dev/192#formatting.
Tabel Markdown dan HTML mentah tidak boleh digunakan dalam komentar proto.
Menambahkan ErrorInfo untuk penanganan error.
Menambahkan Payload Besar untuk pola desain.
2020-04
Mengganti nama Cloud API menjadi Google Cloud API dalam glosarium.
Memperkenalkan API dan layanan sebagai sinonim layanan API.
2020-02
Memperbarui pembuatan versi untuk menambahkan dua strategi pembuatan versi (berbasis channel dan berbasis rilis), menghapus panduan tentang versi poin, dan mengubah cara kami merujuk ke pembuatan versi semantik.
2020-01
Menambahkan retensi data ke pola desain.
2019-11
Menambahkan Cloud API terminologi ke glosarium.
Sarankan klien untuk mencoba lagi hanya untuk error UNAVAILABLE.
2019-06
Tambahkan "Bool vs Enum vs String" ke pola desain.
2019-03
Tambahkan parameter sistem ke kolom standar.
2019-02
Menambahkan nama cakupan domain ke pola desain.
2018-03
Menambahkan semantik penutupan sebagian streaming ke pola desain.
2018-02
Tambahkan read_time ke Kolom Standar.
2018-01
Menambahkan referensi skema untuk Definisi Layanan API.
2017-12
Memperjelas bahwa versi utama API harus menjadi komponen terakhir dari nama paket proto.
2017-11
Jelaskan alasan metode Create mengambil resource input.
Memperjelas ID koleksi yang tidak memiliki bentuk jamak, seperti bukti dan
cuaca.
Menambahkan resource singleton ke pola desain.
Memperjelas konvensi penamaan C# untuk akronim dan versi.
2017-09
Menambahkan mime_type ke kolom standar.
Menambahkan expire_time ke kolom standar.
Menambahkan start_time dan end_time ke kolom standar.
2017-02
Tambahkan "Endpoint API" ke glosarium.
Menambahkan update_mask ke kolom standar.
Menambahkan link ke FieldMask ke metode standar.
Sebutkan bahwa spesifikasi OpenAPI tidak mendukung bilangan bulat tidak bertanda.
Memperjelas bahwa nama metode harus menggunakan kata kerja dalam mood imperatif.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThis changelog documents updates to the API Design Guide, including changes to terminology, error handling, and field requirements.\u003c/p\u003e\n"],["\u003cp\u003eRecent changes include redirecting certain design pages to Google AIPs and updating terminology to align with Google API standards.\u003c/p\u003e\n"],["\u003cp\u003eThe guide has undergone modifications to field descriptions, versioning strategies, and the inclusion of standard fields like \u003ccode\u003eread_time\u003c/code\u003e, \u003ccode\u003emime_type\u003c/code\u003e, \u003ccode\u003eexpire_time\u003c/code\u003e, \u003ccode\u003estart_time\u003c/code\u003e, and \u003ccode\u003eend_time\u003c/code\u003e over time.\u003c/p\u003e\n"],["\u003cp\u003eError handling has been improved with updates to \u003ccode\u003egoogle.rpc.ErrorInfo\u003c/code\u003e and \u003ccode\u003egoogle.api.ErrorReason\u003c/code\u003e, along with guidance on troubleshooting errors and the addition of \u003ccode\u003eErrorInfo\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDesign patterns have been added and enhanced, with examples such as streaming half-close semantics, singleton resources, data retention, and guidance on bool vs enum vs string.\u003c/p\u003e\n"]]],[],null,["# Changelog\n\nThis Changelog highlights notable changes to the\n[API Design Guide](/apis/design).\n\n2025-06\n-------\n\n- Redirected Design page Naming Convention to Google AIP.\n\n2024-10\n-------\n\n- Redirected Design pages to Google AIPs, except for Directory Structure and Naming Conventions.\n\n2021-12\n-------\n\n- Changed terminology Networked API to Network API for consistency with https://google.aip.dev/9.\n\n2021-09\n-------\n\n- Document both Google API error format v1 and v2.\n\n2021-04\n-------\n\n- Introduced visibility-based versioning.\n\n- Introduced API title to glossary.\n\n2021-03\n-------\n\n- Added annotation for output only fields.\n\n- Update enum value guidance to always include an explicit `_UNSPECIFIED`\n value.\n\n- Add guidance on how to generate and parse resource names.\n\n- Add `progress_percent` to standard fields.\n\n2021-02\n-------\n\n- Added guidance on proto3 `optional` primitive fields.\n\n2021-01\n-------\n\n- Updated the Errors page to cover the latest improvement related to\n `google.rpc.ErrorInfo` and `google.api.ErrorReason`.\n\n- Added guidance on how to use `oauth2l`, `curl`, and System Parameters\n to troubleshoot errors with Google APIs.\n\n- Added `502` error code explanation to the Errors page. It is a network\n error instead of an API error.\n\n2020-12\n-------\n\n- Package names should use singlar component names for global consistency. Package names must not use underscores.\n\n2020-09\n-------\n\n- Cleaned up some field description requirements; changed some uses of \"must\"\n outside RFC 2119 to be RFC 2119 \"should\" directives.\n\n- Removed the `bool deleted` standard field, in favor of\n `google.protobuf.Timestamp delete_time` (which was already listed).\n\n2020-07\n-------\n\n- Updated documentation.md to match https://google.aip.dev/192#formatting.\n Markdown tables and raw HTML must not be used in proto comments.\n\n- Added `ErrorInfo` for error handling.\n\n- Added Large Payloads for design patterns.\n\n2020-04\n-------\n\n- Renamed Cloud APIs to Google Cloud APIs in glossary.\n- Introduced API and service as synonyms of API service.\n\n2020-02\n-------\n\n- Updated versioning to add two versioning strategies (channel-based and release-based), remove guidance on point versions, and change how we refer to semantic versioning.\n\n2020-01\n-------\n\n- Add data retention to design patterns.\n\n2019-11\n-------\n\n- Add terminology Cloud APIs to glossary.\n- Recommend clients to retry only for UNAVAILABLE errors.\n\n2019-06\n-------\n\n- Add \"Bool vs Enum vs String\" to design patterns.\n\n2019-03\n-------\n\n- Add system parameters to standard fields.\n\n2019-02\n-------\n\n- Add domain-scoped names to design patterns.\n\n2018-03\n-------\n\n- Add streaming half-close semantics to design patterns.\n\n2018-02\n-------\n\n- Add `read_time` to Standard Fields.\n\n2018-01\n-------\n\n- Add schema reference for API Service Definition.\n\n2017-12\n-------\n\n- Clarify API major version must be the last component of proto package name.\n\n2017-11\n-------\n\n- Clarify why the `Create` method take an input resource.\n- Clarify collection IDs that don't have plural form, such as evidence and weather.\n- Add singleton resource to design patterns.\n- Clarify C# naming conventions for acronyms and versions.\n\n2017-09\n-------\n\n- Add `mime_type` to standard fields.\n- Add `expire_time` to standard fields.\n- Add `start_time` and `end_time` to standard fields.\n\n2017-02\n-------\n\n- Add \"API endpoint\" to glossary.\n- Add `update_mask` to standard fields.\n- Add a link to `FieldMask` to standard methods.\n- Mention that OpenAPI spec does not support unsigned integers.\n- Clarify that method names should use verbs in the imperative mood."]]
