Method: properties.audienceLists.create

Tạo danh sách đối tượng để truy xuất sau. Phương thức này nhanh chóng trả về tên tài nguyên của danh sách đối tượng và bắt đầu một yêu cầu không đồng bộ chạy trong thời gian dài để tạo danh sách đối tượng. Để liệt kê người dùng trong một danh sách đối tượng, trước tiên hãy tạo danh sách đối tượng thông qua phương thức này, sau đó gửi tên tài nguyên đối tượng đến phương thức audienceLists.query.

Xem bài viết Tạo Danh sách đối tượng để biết giới thiệu về Danh sách đối tượng kèm theo các ví dụ.

Danh sách đối tượng là thông tin tổng quan nhanh về những người dùng hiện có trong đối tượng tại thời điểm tạo danh sách đối tượng. Việc tạo danh sách đối tượng cho một đối tượng vào các ngày khác nhau sẽ trả lại các kết quả khác nhau khi người dùng nhập và thoát khỏi đối tượng đó.

Đối tượng trong Google Analytics 4 cho phép bạn phân chia người dùng thành những phân khúc quan trọng đối với công việc kinh doanh của bạn. Để tìm hiểu thêm, hãy xem https://support.google.com/analytics/answer/9267572. Danh sách đối tượng chứa những người dùng trong mỗi đối tượng.

Phương thức này hiện có độ ổn định ở giai đoạn beta tại audienceExports.create. Để gửi ý kiến phản hồi về API này, hãy hoàn tất biểu mẫu Ý kiến phản hồi về Google Analytics Audience Export API.

Yêu cầu HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Tài nguyên chính nơi danh sách đối tượng này sẽ được tạo. Định dạng properties/{property}

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của AudienceList.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của Operation.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics