Migrar para a API Admin do Google Analytics para exclusão de usuários

A API User Deletion legada do Google Analytics (v3) foi descontinuada junto com o Universal Analytics. A API Admin do Google Analytics (v1alpha) oferece um método substituto SubmitUserDeletion para solicitar a exclusão de dados de usuários em propriedades do Google Analytics.

Preciso migrar?

Se o código ainda estiver chamando o método upsert da API User Deletion legada (v3), será necessário migrar para a API Admin do Google Analytics para realizar exclusões de usuários nas propriedades do Google Analytics.

Etapas da migração

Siga estas etapas para começar a usar o novo método SubmitUserDeletion.

Ativar a API Admin do Google Analytics

Clique no botão Ativar a API Admin do Google Analytics a seguir para selecionar ou criar um novo projeto do Google Cloud e ativar automaticamente a API Admin do Google Analytics.

Ativar a API Admin do Google Analytics

Encontrar e substituir chamadas para a API User Deletion legada

Substitua todas as chamadas para o método upsert da API User Deletion legada por chamadas para o novo método SubmitUserDeletion da API Admin do Google Analytics.

Exemplo de solicitação upsert para a API User Deletion legada:

REST

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

Exemplo de uma solicitação SubmitUserDeletion equivalente da API Admin do Google Analytics:

REST

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

Atualizar os escopos OAuth solicitados

O novo SubmitUserDeletion da API Admin do Google Analytics usa o escopo https://www.googleapis.com/auth/analytics.edit.

Isso é diferente da API User Deletion legada, que usava o escopo https://www.googleapis.com/auth/analytics.user.deletion.

Atualize todos os comandos de solicitação de código ou token de acesso que estão usando https://www.googleapis.com/auth/analytics.user.deletion para solicitar https://www.googleapis.com/auth/analytics.edit.

Se você estiver usando uma biblioteca de cliente, ela vai solicitar os escopos necessários automaticamente.

Desativar a API legada

Depois de atualizar o código para usar o método SubmitUserDeletion, você poderá desativar a API legada no projeto do Google Cloud.

Abra o link a seguir para abrir o endpoint de API Universal Analytics legada no console do Google Cloud Console. Selecione o projeto do Cloud e clique no botão Desativar API.