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

User Deletion API (phiên bản 3) cũ của Google Analytics đã ngừng hoạt động cùng với Universal Analytics. Google Analytics Admin API (v1alpha) cung cấp một 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 đang gọi phương thức upsert của User Deletion API (v3) cũ, thì bạn phải di chuyển sang Google Analytics Admin API để thực hiện việc xoá người dùng cho các tài sản Google Analytics của mình.

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 mới và tự động bật API Quản trị của Google Analytics.

Bật API Google Analytics

Tìm và thay thế các lệnh gọi đến User Deletion API cũ

Thay thế mọi lệnh gọi đến phương thức upsert cũ của API Xoá người dùng cũ bằng lệnh gọi đến phương thức SubmitUserDeletion mới của API Quản trị Google Analytics.

Ví dụ về yêu cầu upsert đối với User Deletion API 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 các 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.

API 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 lệnh yêu cầu mã hoặc 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 đang sử dụng một 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 có thể tắt API cũ trong dự án Google Cloud.

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