REST Resource: properties.recurringAudienceLists

Tài nguyên: PeriodicAudienceList

Danh sách đối tượng định kỳ tạo ra danh sách đối tượng mới mỗi ngày. Danh sách đối tượng là những người dùng thuộc một đối tượng tại thời điểm tạo danh sách. Danh sách đối tượng định kỳ đảm bảo rằng bạn có danh sách đối tượng dựa trên dữ liệu gần đây nhất có sẵn để sử dụng mỗi ngày.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng. Tên tài nguyên danh sách đối tượng định kỳ được chỉ định trong quá trình tạo. Tên tài nguyên này xác định RecurringAudienceList này.

Định dạng properties/{property}/recurringAudienceLists/{recurringAudienceList}
audience

string

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 properties/{property}/audiences/{audience}
audienceDisplayName

string

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[]

object (AudienceDimension)

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 danh sách đối tượng.
audienceLists[]

string

Chỉ có đầu ra. Tên tài nguyên danh sách đối tượng cho các phiên bản danh sách đối tượng đã được tạo cho danh sách đối tượng định kỳ này. Một danh sách đối tượng được tạo cho mỗi ngày và danh sách đối tượng đó sẽ được liệt kê tại đây.

Danh sách này được sắp xếp theo thứ tự tương ứng với danh sách đối tượng được tạo gần đây nhất.
activeDaysRemaining

integer

Không bắt buộc. Số ngày còn lại mà một lượt xuất đối tượng định kỳ sẽ tạo ra một bản sao danh sách đối tượng. Bộ đếm này giảm đi 1 mỗi ngày và khi bộ đếm về 0 thì sẽ không có danh sách đối tượng mới nào được tạo.

Yêu cầu danh sách đối tượng định kỳ cho tài sản Analytics 360 sẽ được mặc định là 180 ngày và có thời hạn tối đa là 365 ngày. Theo mặc định, các yêu cầu đối với tài sản Analytics chuẩn là 14 ngày và tối đa là 30 ngày.

Giá trị tối thiểu được phép trong quá trình tạo là 1. Các yêu cầu vượt quá mức tối đa tương ứng sẽ bị buộc chuyển sang mức tối đa.
webhookNotification

object (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 định kỳ tạo danh sách đối tượng mới. 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ò.

Hai yêu cầu POST sẽ được gửi mỗi khi danh sách đối tượng định kỳ tạo danh sách đối tượng. Điều này xảy ra một lần mỗi ngày cho đến khi danh sách đối tượng định kỳ đạt đến 0 ngày hoạt động còn lại. Yêu cầu đầu tiên sẽ được gửi cho biết danh sách đối tượng mới được tạo ở trạng thái TẠO. Yêu cầu 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).

Phương thức

create

 Tạo danh sách đối tượng định kỳ.

get

 Lấy siêu dữ liệu cấu hình về một danh sách đối tượng định kỳ cụ thể.

list

 Liệt kê tất cả danh sách đối tượng định kỳ cho một tài sản.