Google 애널리틱스 User Deletion API에서 이전

기존 Google 애널리틱스 User Deletion API가 지원 중단됩니다. Google 애널리틱스 Admin API는 지정된 사용자의 데이터 삭제를 요청하는 대체 SubmitUserDeletion 메서드를 제공합니다.

마이그레이션해야 하나요?

코드에서 기존 사용자 삭제 API의 upsert 메서드를 호출하는 경우 사용자 삭제 기능을 계속 사용하려면 코드를 이전해야 합니다.

이전 단계

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

Google Analytics Admin API 사용 설정

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

Google Analytics Admin API 사용 설정

기존 사용자 삭제 API 호출 찾기 및 바꾸기

기존 사용자 삭제 API의 기존 upsert 메서드에 대한 호출을 Google 애널리틱스 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 애널리틱스 Admin API의 동등한 SubmitUserDeletion 요청의 예:

REST

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

요청된 OAuth 범위 업데이트

새로운 Google 애널리틱스 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 엔드포인트를 엽니다. 클라우드 프로젝트를 선택하고 API 사용 중지 버튼을 클릭합니다.