REST Resource: properties.recurringAudienceLists

Tài nguyên: RecurringAudienceList

Danh sách đối tượng định kỳ sẽ 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 mới nhất hiện có để 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 của 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 đối tượng. Tên tài nguyên này xác định đối tượng đang được liệt kê và được chia sẻ giữa API Quản trị và API Dữ liệu Analytics.

Định dạng properties/{property}/audiences/{audience}
audienceDisplayName

string

Chỉ có đầu ra. Tên hiển thị 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à hiển thị 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 thực thể danh sách đối tượng được tạo cho danh sách đối tượng định kỳ này. Hệ thống sẽ tạo một danh sách đối tượng 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ự 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 một thực thể danh sách đối tượng. Bộ đếm này giảm đi 1 mỗi ngày và khi đạt đến 0, hệ thống sẽ không tạo danh sách đối tượng mới.

Yêu cầu danh sách đối tượng định kỳ cho tài sản Analytics 360 mặc định là 180 ngày và tối đa là 365 ngày. Yêu cầu đối với tài sản Analytics chuẩn có thời hạn mặc định 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ị ép buộc ở mức tối đa.
webhookNotification

object (WebhookNotification)

Không bắt buộc. Định cấu hình thông báo webhook được gửi từ API Dữ liệu Google Analytics đến máy chủ webhook của bạn. Bạn không bắt buộc phải sử dụng webhook. Nếu không sử dụng, bạn 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 gửi thông báo đến máy chủ của bạn và không cần thăm dò ý kiến.

Hệ thống sẽ gửi 2 yêu cầu POST mỗi khi danh sách đối tượng định kỳ tạo một danh sách đối tượng. Việc này diễn 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 thấy danh sách đối tượng mới tạo ở trạng thái ĐANG 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 ACTIVE (ĐANG CHẠY) hoặc FAILED (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.