Tài nguyên: AudienceList
Danh sách đối tượng là danh sách gồm những người dùng thuộc một đối tượng tại thời điểm tạo danh sách. Một đối tượng có thể được tạo nhiều danh sách đối tượng cho nhiều ngày.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "audience": string, "audienceDisplayName": string, "dimensions": [ { object ( |
Trường | |
---|---|
name |
Chỉ có đầu ra. Giá trị nhận dạng. Tên tài nguyên danh sách đối tượng được chỉ định trong quá trình tạo. Tên tài nguyên này xác định Định dạng |
audience |
Bắt buộc. Tên tài nguyên cho đối tượng. Tên tài nguyên này xác định đối tượng được liệt kê và được chia sẻ giữa các API Quản trị và Dữ liệu của Analytics. Định dạng |
audienceDisplayName |
Chỉ có đầu ra. Tên hiển thị mang tính mô tả cho đối tượng này. Ví dụ: "Người mua". |
dimensions[] |
Bắt buộc. Các phương diện được yêu cầu và xuất hiện trong phản hồi truy vấn. |
creationQuotaTokensCharged |
Chỉ có đầu ra. Tổng mã thông báo hạn mức được tính trong quá trình tạo Danh sách đối tượng. Vì số lượng mã thông báo này dựa trên hoạt động ở trạng thái |
state |
Chỉ có đầu ra. Trạng thái hiện tại của Danh sách đối tượng này. |
beginCreatingTime |
Chỉ có đầu ra. Thời điểm audienceLists.create được gọi và AudienceList bắt đầu trạng thái Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
rowCount |
Chỉ có đầu ra. Tổng số hàng trong kết quả AudienceList. |
errorMessage |
Chỉ có đầu ra. Thông báo lỗi sẽ được điền khi tạo danh sách đối tượng không thành công trong quá trình tạo. Lý do phổ biến dẫn đến việc không thành công như vậy là hết hạn mức. |
percentageCompleted |
Chỉ có đầu ra. Tỷ lệ phần trăm hoàn tất cho lượt xuất đối tượng này nằm trong khoảng từ 0 đến 100. |
recurringAudienceList |
Chỉ có đầu ra. Danh sách đối tượng định kỳ đã tạo danh sách đối tượng này. Danh sách đối tượng định kỳ tạo danh sách đối tượng hằng ngày. Nếu danh sách đối tượng được tạo trực tiếp, chúng sẽ không có danh sách đối tượng định kỳ được liên kết và trường này sẽ được để trống. |
webhookNotification |
Không bắt buộc. Thiết lập thông báo webhook mà bạn sẽ gửi từ Google Analytics Data API đến máy chủ webhook. Bạn không bắt buộc phải sử dụng webhook. Nếu không sử dụng, bạn sẽ cần thăm dò ý kiến API này để xác định thời điểm danh sách đối tượng sẵn sàng sử dụng. Webhook cho phép thông báo được gửi đến máy chủ của bạn và tránh cần thăm dò. Một hoặc hai yêu cầu POST sẽ được gửi đến webhook. Yêu cầu POST đầu tiên sẽ được gửi ngay lập tức hiển thị danh sách đối tượng mới tạo ở trạng thái TẠO. Yêu cầu POST thứ hai sẽ được gửi sau khi danh sách đối tượng hoàn tất quá trình tạo (trạng thái HOẠT ĐỘNG hoặc KHÔNG THÀNH CÔNG). Nếu các danh sách đối tượng giống nhau được yêu cầu liên tiếp một cách nhanh chóng, thì danh sách đối tượng thứ hai và các danh sách đối tượng tiếp theo có thể được phân phát từ bộ nhớ đệm. Trong trường hợp đó, phương thức tạo danh sách đối tượng có thể trả về danh sách đối tượng đã HOẠT ĐỘNG. Trong trường hợp này, chỉ một yêu cầu POST sẽ được gửi đến webhook. |
Tiểu bang
Danh sách đối tượng hiện tồn tại ở trạng thái này.
Enum | |
---|---|
STATE_UNSPECIFIED |
Trạng thái chưa xác định sẽ không bao giờ được sử dụng. |
CREATING |
AudienceList đang được tạo và sẽ có thể sử dụng trong tương lai. Quá trình tạo sẽ diễn ra ngay sau lệnh gọi AudienceLists.create. |
ACTIVE |
AudienceList đã được tạo hoàn chỉnh và sẵn sàng để truy vấn. AudienceList được cập nhật thành hoạt động không đồng bộ từ một yêu cầu; điều này xảy ra một khoảng thời gian (ví dụ: 15 phút) sau lệnh gọi tạo ban đầu. |
FAILED |
Không thể tạo Danh sách đối tượng. Có khả năng việc yêu cầu lại danh sách đối tượng này sẽ thành công. |
Phương thức |
|
---|---|
|
Tạo danh sách đối tượng để truy xuất sau. |
|
Xuất danh sách đối tượng gồm những người dùng sang Google Trang tính. |
|
Lấy siêu dữ liệu cấu hình về một danh sách đối tượng cụ thể. |
|
Liệt kê tất cả danh sách đối tượng cho một tài sản. |
|
Truy xuất danh sách đối tượng của người dùng. |