변경 로그

아래 변경 로그는 API 디자인 가이드의 주요 변경사항을 나타낸 것입니다.

2020-09

  • 이미 나열된 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 용어가 추가되었습니다.
  • 클라이언트가 사용할 수 없는 오류에 대해서만 재 시도하도록 하는 것이 좋습니다.

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_timeend_time이 추가되었습니다.

2017-02

  • "API 엔드포인트"가 용어집에 추가되었습니다.
  • 표준 필드에 update_mask가 추가되었습니다.
  • 표준 메서드에 FieldMask에 대한 링크가 추가되었습니다.
  • OpenAPI 사양은 무부호 정수를 지원하지 않는다고 언급하였습니다.
  • 메소드 이름에서는 동사를 명령법으로 사용해야 한다고 명확하게 설명하였습니다.