아래 변경 로그는 API 디자인 가이드의 주요 변경사항을 나타낸 것입니다.
2021-12
- https://google.aip.dev/9와의 일관성을 위해 Networked API 용어를 Network API로 변경했습니다.
2021-09
- Google API 오류 형식 v1 및 v2가 모두 문서화되었습니다.
2021-04
공개 상태 기반 버전 관리를 도입했습니다.
용어집에 API 제목을 도입했습니다.
2021-03
출력 전용 필드에 대한 주석을 추가했습니다.
항상 명시적인
_UNSPECIFIED
값을 포함하도록 열거형 값 지침을 업데이트되었습니다.리소스 이름을 생성하고 파싱하는 방법에 대한 지침이 추가되었습니다.
표준 필드에
progress_percent
가 추가되었습니다.
2021-02
- proto3
optional
기본 필드에 대한 지침이 추가되었습니다.
2021-01
google.rpc.ErrorInfo
및google.api.ErrorReason
과 관련된 최신 개선사항을 포괄하도록 오류 페이지가 업데이트되었습니다.oauth2l
,curl
, 시스템 매개변수를 사용하여 Google API 관련 오류를 해결하는 방법에 대한 지침이 추가되었습니다.오류 페이지에
502
오류 코드 설명이 추가되었습니다. API 오류 대신 네트워크 오류입니다.
2020-12
- 패키지 이름은 전역 일관성을 위해 단수 구성요소 이름을 사용해야 합니다. 패키지 이름에 밑줄을 사용해서는 안 됩니다.
2020-09
일부 필드 설명 요구사항을 정리했습니다. RFC 2119 외부에서 일부 'must'의 사용이 RFC 2119 'should' 명령어로 변경되었습니다.
이미 나열된
google.protobuf.Timestamp delete_time
을 위해bool deleted
표준 필드를 삭제했습니다.
2020-07
documentation.md가 https://google.aip.dev/192#formatting과 일치하도록 업데이트되었습니다. proto 주석에는 마크다운 테이블과 원시 HTML을 사용하면 안 됩니다.
오류 처리를 위해
ErrorInfo
를 추가하였습니다.설계 패턴을 위해 대규모 페이로드를 추가했습니다.
2020-04
- 용어집에서 Cloud API 이름이 Google Cloud API로 변경되었습니다.
- API와 서비스가 API 서비스의 동의어로 도입되었습니다.
2020-02
- 두 가지 버전 관리 전략(채널 기반 및 출시 기반)을 추가하고, 포인트 버전에 대한 안내를 제거하고, 시맨틱 버전 관리를 참조하는 방식을 변경하도록 버전 관리가 업데이트되었습니다.
2020-01
- 디자인 패턴에 데이터 보관이 추가되었습니다.
2019-11
- 용어집에 Cloud API 용어가 추가되었습니다.
- 클라이언트가 UNAVAILABLE 오류에 대해서만 재시도하도록 하는 것이 좋습니다.
2019-06
- '부울, 열거형, 문자열 간의 비교'가 디자인 패턴에 추가되었습니다.
2019-03
- 표준 필드에 시스템 매개변수가 추가되었습니다.
2019-02
- 도메인 범위 이름이 디자인 패턴에 추가되었습니다.
2018-03
- 스트리밍 절반 종료 시맨틱스가 디자인 패턴에 추가되었습니다.
2018-02
- 표준 필드에
read_time
이 추가되었습니다.
2018-01
- API 서비스 정의에 대한 스키마 참조가 추가되었습니다.
2017-12
- API 주 버전은 proto 패키지 이름에서 마지막 구성요소가 되어야 한다는 사실을 명확하게 설명하였습니다.
2017-11
Create
메서드에 입력 리소스가 필요한 이유를 명확하게 설명하였습니다.- 증거와 날씨처럼 복수 형태를 갖지 않는 컬렉션 ID에 대해 명확하게 설명하였습니다.
- 싱글톤 리소스를 디자인 패턴에 추가하였습니다.
- 약어와 버전에 적용되는 C# 이름 지정 규칙에 대해 명확하게 설명하였습니다.
2017-09
- 표준 필드에
mime_type
이 추가되었습니다. - 표준 필드에
expire_time
이 추가되었습니다. - 표준 필드에
start_time
및end_time
이 추가되었습니다.
2017-02
- "API 엔드포인트"가 용어집에 추가되었습니다.
- 표준 필드에
update_mask
가 추가되었습니다. - 표준 메서드에
FieldMask
에 대한 링크가 추가되었습니다. - OpenAPI 사양은 무부호 정수를 지원하지 않는다고 언급하였습니다.
- 메소드 이름에서는 동사를 명령법으로 사용해야 한다고 명확하게 설명하였습니다.