Google 애널리틱스 API에 대한 데이터 지원 중단 정책

이 문서에서는 Core Reporting API 및 Metadata API의 데이터 지원 중단 정책을 설명합니다.

개요

측정기준 및 측정항목 (열)은 Google 애널리틱스 Reporting API를 쿼리하는 데 사용됩니다. 이러한 열을 추가 또는 삭제하거나 이름을 변경해야 하는 경우도 있습니다. 데이터 지원 중단 정책은 이러한 변경사항이 어떻게 적용되는지 투명하게 알리기 위해 제공됩니다.

모든 열 변경사항은 변경 로그를 통해 전달되며 Metadata API 는 이러한 변경사항을 반영하도록 자동으로 업데이트됩니다.

이 정책의 적용 대상

이 정책은 공개 API에서 노출되는 측정기준 및 측정항목에 적용됩니다. API 요청 (쿼리 매개변수), API 응답, API에서 반환된 값 또는 측정기준과 측정항목의 올바른 조합은 다루지 않습니다.

새 데이터

API에 새 열이 추가된 경우:

  • 해당 API의 변경 로그가 새 열에 관한 세부정보로 업데이트됩니다.
  • Metadata API에서 열을 사용할 수 있습니다.

데이터 삭제

API에서 열이 삭제되는 경우:

  • 해당하는 API의 변경 로그가 삭제되는 열에 관한 세부정보로 업데이트됩니다.
  • Metadata API에서 열 status 속성은 DEPRECATED로 설정됩니다.
  • 이 열은 최소 6개월 동안 보고 쿼리에서 계속 작동합니다.
  • 6개월 후에는 열이 Metadata API에서 삭제되고 Reporting API에서 열을 쿼리하면 400 Bad Request 오류가 발생합니다.

데이터 이름 변경

열 이름 변경 시:

  • 해당하는 API의 변경 로그가 원래 열과 대체 열에 관한 세부정보로 업데이트됩니다.
  • Metadata API 에서 원본 열의 status 속성은 DEPRECATED으로 설정되고 replacedBy 속성은 대체 열의 ID로 설정됩니다.
  • 원본 열은 최소 6개월 동안 보고 쿼리에서 계속 작동합니다.
  • 6개월 후에는 원래 열이 Metadata API에서 삭제되고 Reporting API에서 열을 쿼리하면 400 Bad Request 오류가 발생합니다.

속성 삭제

Metadata API에서 속성이 삭제되면 다음과 같은 결과가 발생합니다.

  • Metadata API 변경 로그가 삭제되는 속성에 대한 세부정보로 업데이트됩니다.
  • 이 속성은 최소 6개월 동안 Metadata API에서 계속 사용할 수 있습니다.
  • 6개월 후 Metadata API에서 속성이 삭제됩니다.

그룹

경우에 따라 그룹의 이름 또는 열 순서를 변경해야 합니다. 이 경우 다음 상황이 발생합니다.