Migrar da API User Deletion do Google Analytics

A API User Deletion legada do Google Analytics será desativada. A API Admin do Google Analytics oferece um método SubmitUserDeletion substituto para solicitar a exclusão de dados de um determinado usuário.

Preciso migrar?

Se o código estiver chamando o método upsert da API User Deletion legada, migre o código para continuar usando a funcionalidade de exclusão de usuários.

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 para selecionar ou criar um 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 legado da API User Deletion legada por chamadas para o novo método SubmitUserDeletion da API Google Analytics Admin.

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 do OAuth solicitados

A nova 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 usam 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 da API Universal Analytics legada no console do Google Cloud. Selecione seu projeto do Cloud e clique no botão Desativar API.