Eseguire la migrazione all'API Google Analytics Admin per l'eliminazione degli utenti

L'API User Deletion di Google Analytics (v3) legacy è stata ritirata insieme a Universal Analytics. L'API Google Analytics Admin (v1alpha) fornisce un metodo sostitutivo SubmitUserDeletion per richiedere l'eliminazione dei dati degli utenti nelle proprietà Google Analytics.

È necessario eseguire la migrazione?

Se il tuo codice continua a chiamare il metodo upsert dell'API User Deletion (v3) legacy, devi eseguire la migrazione all'API Google Analytics Admin per eliminare gli utenti dalle tue proprietà Google Analytics.

Passi per la migrazione

Segui questi passaggi per iniziare a utilizzare il nuovo metodo SubmitUserDeletion.

Abilita l'API Google Analytics Admin

Fai clic sul seguente pulsante Abilita l'API Google Analytics Admin per selezionare o creare un nuovo progetto Google Cloud e abilitare automaticamente l'API Google Analytics Admin.

Abilita l'API Google Analytics Admin

Trova e sostituisci le chiamate all'API User Deletion legacy

Sostituisci tutte le chiamate al metodo legacy upsert dell'API User Deletion legacy con chiamate al nuovo metodo SubmitUserDeletion dell'API Google Analytics Admin.

Esempio di richiesta upsert all'API User Deletion legacy:

REST

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

Esempio di una richiesta SubmitUserDeletion equivalente dell'API Google Analytics Admin:

REST

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

Aggiorna gli ambiti OAuth richiesti

Il nuovo metodo SubmitUserDeletion dell'API Google Analytics Admin utilizza l'ambito https://www.googleapis.com/auth/analytics.edit.

Questo è diverso dall'API User Deletion legacy, che utilizzava l'ambito https://www.googleapis.com/auth/analytics.user.deletion.

Devi aggiornare tutti i comandi di richiesta di codice o token di accesso che utilizzano https://www.googleapis.com/auth/analytics.user.deletion in modo che richiedano https://www.googleapis.com/auth/analytics.edit.

Se utilizzi una libreria client, questa dovrebbe richiedere automaticamente gli ambiti necessari.

Disabilita l'API legacy

Dopo aver aggiornato il codice in modo che utilizzi il metodo SubmitUserDeletion, puoi disabilitare l'API legacy nel tuo progetto Google Cloud.

Apri il seguente link per aprire l'endpoint dell'API Universal Analytics legacy nella console Google Cloud. Seleziona il progetto Cloud e fai clic sul pulsante Disabilita API.