Di chuyển sang API Quản trị của Google Analytics để xoá người dùng

API Xoá người dùng cũ của Google Analytics (phiên bản 3) đã ngừng hoạt động cùng với Universal Analytics. API Quản trị của Google Analytics (v1alpha) cung cấp phương thức thay thế SubmitUserDeletion để yêu cầu xoá dữ liệu của người dùng trong các tài sản Google Analytics.

Tôi có cần di chuyển không?

Nếu mã của bạn vẫn gọi phương thức upsert của API Xoá người dùng cũ (phiên bản 3), thì bạn phải di chuyển sang Google Analytics Admin API để xoá người dùng cho các tài sản Google Analytics.

Các bước di chuyển

Hãy làm theo các bước sau để bắt đầu sử dụng phương thức SubmitUserDeletion mới.

Bật Google Analytics Admin API

Nhấp vào nút Bật API Quản trị của Google Analytics sau đây để chọn hoặc tạo một dự án Google Cloud mới và tự động bật API Quản trị của Google Analytics.

Bật Google Analytics Admin API

Tìm và thay thế các lệnh gọi đến API Xoá người dùng cũ

Thay thế mọi lệnh gọi đến phương thức upsert cũ của User Deletion API cũ bằng các lệnh gọi đến phương thức SubmitUserDeletion mới của Google Analytics Admin API.

Ví dụ về yêu cầu upsert đối với API Xoá người dùng cũ:

REST

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

Ví dụ về yêu cầu SubmitUserDeletion tương đương của Google Analytics Admin API:

REST

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

Cập nhật phạm vi OAuth được yêu cầu

SubmitUserDeletion mới của Google Analytics Admin API sử dụng phạm vi https://www.googleapis.com/auth/analytics.edit.

Phạm vi này khác với User Deletion API cũ, vốn sử dụng phạm vi https://www.googleapis.com/auth/analytics.user.deletion.

Bạn nên cập nhật mọi mã hoặc lệnh yêu cầu mã truy cập đang sử dụng https://www.googleapis.com/auth/analytics.user.deletion để yêu cầu https://www.googleapis.com/auth/analytics.edit.

Nếu bạn đang sử dụng thư viện ứng dụng, thì thư viện đó sẽ tự động yêu cầu các phạm vi cần thiết.

Tắt API cũ

Sau khi cập nhật mã để sử dụng phương thức SubmitUserDeletion, bạn đã sẵn sàng tắt API cũ trong dự án trên đám mây Google Cloud.

Mở đường liên kết sau để mở điểm cuối API Universal Analytics cũ trong Google Cloud Console. Chọn Dự án trên Cloud rồi nhấp vào nút Tắt API.