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

Google Analytics User Deletion API (phiên bản 3) cũ đã 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 cho người dùng trong 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 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 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 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 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 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 đ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 trên đám mây của Google.

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 đám mây của bạn rồi nhấp vào nút Tắt API.