REST Resource: properties.recurringAudienceLists

Tài nguyên: Tỷ lệ đối tượng chung

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 đang được liệt kê và được chia sẻ giữa Dữ liệu Analytics và API Quản trị.

Đị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 nội dung phản hồi của 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 đã 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ê ở đâ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 trước tiên.
activeDaysRemaining

integer

Không bắt buộc. Số ngày còn lại mà việc xuất đối tượng định kỳ sẽ tạo ra một phiên bản danh sách đối tượng. Bộ đếm này giảm đi một mỗi ngày và khi bộ đếm về 0, 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 được đặt mặc định là 180 ngày và tối đa là 365 ngày. Theo mặc định, thời gian 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ị chuyển sang mức tối đa.
webhookNotification

object (WebhookNotification)

Không bắt buộc. Định cấu hình thông báo webhook để gửi từ API Dữ liệu của Google Analytics đế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 một 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à để tránh việc thăm dò ý kiến.

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