사용자 삭제를 위한 Google 애널리틱스 Admin API로 이전

기존 Google 애널리틱스 User Deletion API (v3)는 유니버설 애널리틱스와 함께 지원 중단되었습니다. Google Analytics Admin API (v1alpha)는 Google 애널리틱스 속성의 사용자에 대한 데이터 삭제를 요청하는 대체 SubmitUserDeletion 메서드를 제공합니다.

이전을 해야 하나요?

코드가 여전히 기존 User Deletion API (v3)의 upsert 메서드를 호출하는 경우 Google 애널리틱스 속성에 대한 사용자 삭제를 실행하려면 Google Analytics Admin API로 이전해야 합니다.

이전 단계

새 SubmitUserDeletion 메서드를 사용하려면 다음 단계를 따르세요.

Google Analytics Admin API 사용 설정

다음 Google Analytics Admin API 사용 설정 버튼을 클릭하여 새 Google Cloud 프로젝트를 선택하거나 만들고 Google Analytics Admin API를 자동으로 사용 설정합니다.

Google Analytics Admin API 사용 설정

기존 User Deletion API 호출 찾기 및 바꾸기

기존 User Deletion API의 기존 upsert 메서드에 대한 호출을 Google Analytics Admin API의 새 SubmitUserDeletion 메서드에 대한 호출로 바꿉니다.

기존 User Deletion API에 대한 upsert 요청의 예:

REST

  POST https://analytics.googleapis.com/analytics/v3/userDeletion/userDeletionRequests:upsert
  {
    "propertyId": "1234567",
    "id": {
      "type": "USER_ID",
      "userId": "user123"
    }
  }

Google Analytics Admin API의 상응하는 SubmitUserDeletion 요청의 예:

REST

  POST https://analyticsadmin.googleapis.com/v1alpha/properties/1234567:submitUserDeletion
  {
    "userId": "user123"
  }

요청된 OAuth 범위 업데이트

Google Analytics Admin API의 새 SubmitUserDeletion은 https://www.googleapis.com/auth/analytics.edit 범위를 사용합니다.

이는 https://www.googleapis.com/auth/analytics.user.deletion 범위를 사용한 기존 User Deletion API와 다릅니다.

https://www.googleapis.com/auth/analytics.user.deletion을 사용하여 https://www.googleapis.com/auth/analytics.edit을 요청하는 코드 또는 액세스 토큰 요청 명령어를 업데이트해야 합니다.

클라이언트 라이브러리를 사용하는 경우 필요한 범위를 자동으로 요청해야 합니다.

기존 API 사용 중지

SubmitUserDeletion 메서드를 사용하도록 코드를 업데이트한 후 Google Cloud 프로젝트에서 기존 API를 사용 중지할 수 있습니다.

다음 링크 를 열어 Google Cloud 콘솔에서 기존 유니버설 애널리틱스 API 엔드포인트를 엽니다. Cloud 프로젝트를 선택하고 API 사용 중지 버튼을 클릭합니다.