V2 알파에서 마이그레이션

이 페이지는 현재 Cloud Support API의 V2 알파 버전을 사용 중이고 V2 베타로 마이그레이션하려는 고객을 대상으로 합니다.

V2 베타로 시작하기

V2 알파를 이미 사용하는 중이면 V2 베타 시작을 위해 추가 설정을 수행할 필요가 없습니다. 동일한 서비스 계정/사용자 인증 정보를 사용할 수 있고 API가 미리 사용 설정됩니다.

V2 베타 엔드포인트를 호출하려면 단순히 요청 URL의 /v2alpha/ 부분을 /v2beta/로 바꿉니다. 예를 들어 V2 알파에서 V2 베타로 cases.get 호출을 업그레이드하는 방법은 다음과 같습니다.

V2 알파: GET https://cloudsupport.googleapis.com/v2alpha/projects/123/cases/abc

V2 베타: GET https://cloudsupport.googleapis.com/v2beta/projects/123/cases/abc

케이스 분류 브레이킹 체인지

V2 알파에서 V2 베타로 변경된 유일한 동작은 케이스 분류 유형입니다.

V2 알파 CaseClassification

필드 케이스 만들기에 필요 설명
productType string
분류가 해당하는 제품 유형입니다.
value string
케이스를 만들 때 사용할 분류입니다. 예: "기술 문제 > 컴퓨팅 > Compute Engine"

V2 베타 CaseClassification

필드 케이스 만들기에 필요 설명
id string
분류의 고유 ID입니다. 케이스 만들기에 대해 지정되어야 합니다.
displayName 아니요 string
분류의 표시 이름입니다.

이렇게 변경된 이유는 무엇인가요?

  • productType 필드 삭제

    • 초기 API 설계에 따라 이 필드를 추가해야 했지만 API 발전에 따라 지금은 사용되지 않습니다.
    • 이 필드는 필요하지만 GOOGLE_CLOUD 값만 유효합니다. 따라서 모든 케이스 만들기 요청에 상용구처럼 사용됩니다.
  • valueiddisplayName으로 분리

    • V2 알파의 value 필드는 사람이 옵션 목록에서 선택할 수 있도록 사람이 판독 가능한 형태여야 하고 그리고 API가 생성되는 케이스 유형을 식별할 수 있도록 머신이 판독 가능한 형태여야 합니다.
    • V2 베타는 이러한 문제를 두 가지 필드로 분리합니다. id는 분류 중 머신 판독 가능한 부분이고 displayName은 사람 판독 가능한 부분입니다.
    • 그 결과 API 통합을 헤치지 않으면서 표시 이름을 변경할 수 있는 유연성이 확보됩니다. 예를 들어 이후에 displayName의 여러 번역을 사용할 수 있지만 id는 동일한 케이스 분류를 나타낸 이후 모든 번역에 대해 동일하게 유지할 수 있습니다.