V2 베타에서 마이그레이션

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

V2 시작하기

V2 베타를 이미 사용 중인 경우 V2를 사용하기 위해 추가 설정을 수행할 필요가 없습니다. 동일한 서비스 계정 및 사용자 인증 정보를 사용할 수 있습니다. API가 미리 사용 설정됩니다.

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

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

V2: GET https://cloudsupport.googleapis.com/v2/projects/123/cases/abc

SearchCases, Case.severity, Comment.plainTextBody에 대한 브레이킹 체인지

SearchCases 엔드포인트 변경사항

SearchCases 엔드포인트가 다음과 같이 변경되었습니다.

  • 경로가 다음과 같이 변경되었습니다.

    GET https://cloudsupport.googleapis.com/v2/cases:search

    변경 후:

    GET https://cloudsupport.googleapis.com/v2beta/{parent=*/*}/cases:search

  • filter 매개변수는 더 이상 project 또는 organization 필터를 허용하지 않습니다. 대신 URL의 프로젝트/조직이 검색 범위로 사용됩니다.

필드 변경사항

필드가 다음과 같이 변경되었습니다.

  • 케이스의 severity 필드는 삭제되었으며 priority 필드를 사용합니다.

  • 케이스 의견의 plainTextBody 필드는 삭제되었으며 body 필드를 사용합니다.

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

  • SearchCases 경로 변경

    • 검색 범위를 정의하는 기존 방법은 혼란스럽고 표준 Google Cloud Platform API 설계 권장사항과 일치하지 않았습니다.
    • 새로운 방법은 SearchCases를 ListCases와 같은 API의 다른 엔드포인트와 일관되게 유지합니다.

  • Case.severity 필드 삭제

    • 심각도는 우선순위와 동일한 용도로 사용되므로 이를 삭제하면 API가 간소화됩니다.

  • Comment.plainTextBody 필드 삭제

    • Comment.body는 일반 텍스트만 포함하므로 이 필드와 중복됩니다. 따라서 plainTextBody를 삭제하여 API를 간소화합니다.

변경사항에 맞춰 적응하는 방법

  • SearchCase 요청에서 project 및 organization 필터를 삭제하고 대신 요청 URL에서 선언합니다.

  • severity 필드를 사용했던 위치에 priority 필드를 사용합니다. 시맨틱 의미에서 매우 유사하므로 일반적으로 이러한 참조를 교체할 수 있습니다.

  • plainTextBody 필드 대신 body 필드를 사용합니다. 동일한 정보가 포함되어 있으므로 plainTextBody에 대한 모든 참조를 body로 바꾸는 것이 좋습니다.