아래 변경 로그는 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 사양은 무부호 정수를 지원하지 않는다고 언급하였습니다.
- 메소드 이름에서는 동사를 명령법으로 사용해야 한다고 명확하게 설명하였습니다.