Method: properties.audienceExports.query

Truy xuất dữ liệu xuất đối tượng người dùng. Sau khi bạn tạo đối tượng, người dùng sẽ không có sẵn để xuất ngay lập tức. Trước tiên, bạn cần có một yêu cầu đến audienceExports.create để tạo một bản xuất đối tượng người dùng, sau đó, phương thức này được dùng để truy xuất người dùng trong bản xuất đối tượng.

Hãy xem phần Tạo tệp xuất đối tượng để biết thông tin giới thiệu về tính năng Xuất đối tượng kèm theo ví dụ.

Đối tượng trong Google Analytics 4 giúp bạn phân đoạn người dùng theo những khía cạnh quan trọng đối với hoạt động kinh doanh của mình. Để tìm hiểu thêm, hãy xem bài viết https://support.google.com/analytics/answer/9267572.

Audience Export API có một số phương thức ở trạng thái alpha và một số phương thức khác ở trạng thái ổn định beta. Mục đích là để nâng cấp các phương thức lên độ ổn định beta sau khi nhận được một số ý kiến phản hồi và được áp dụng. Để 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/v1beta/{name=properties/*/audienceExports/*}:query

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

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên của hoạt động xuất đối tượng cần truy xuất người dùng. Định dạng properties/{property}/audienceExports/{audienceExport}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "offset": string,
  "limit": string
}
Trường
offset

string (int64 format)

Không bắt buộc. Số hàng của hàng bắt đầu. Hàng đầu tiên được tính là hàng 0.

Khi phân trang, yêu cầu đầu tiên không chỉ định độ lệch; hoặc tương đương với việc đặt độ lệch thành 0; yêu cầu đầu tiên trả về limit hàng đầu tiên. Yêu cầu thứ hai đặt độ lệch thành limit của yêu cầu đầu tiên; yêu cầu thứ hai trả về limit thứ hai của các hàng.

Để tìm hiểu thêm về tham số phân trang này, hãy xem phần Phân trang.
limit

string (int64 format)

Không bắt buộc. Số hàng sẽ trả về. Nếu bạn không chỉ định, thì 10.000 hàng sẽ được trả về. API này trả về tối đa 250.000 hàng cho mỗi yêu cầu, bất kể bạn yêu cầu bao nhiêu hàng. limit phải là số dương.

API cũng có thể trả về ít hàng hơn limit được yêu cầu, nếu không có nhiều giá trị phương diện như limit.

Để tìm hiểu thêm về tham số phân trang này, hãy xem phần Phân trang.

Nội dung phản hồi

Danh sách người dùng trong một tệp xuất đối tượng.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
Trường
audienceRows[]

object (AudienceRow)

Hàng cho mỗi người dùng trong một tệp xuất đối tượng. Số lượng hàng trong phản hồi này sẽ nhỏ hơn hoặc bằng kích thước trang của yêu cầu.
audienceExport

object (AudienceExport)

Dữ liệu cấu hình về AudienceExport đang được truy vấn. Được trả về để giúp diễn giải các hàng đối tượng trong phản hồi này. Ví dụ: các phương diện trong AudienceExport này tương ứng với các cột trong AudienceRows.
rowCount

integer

Tổng số hàng trong kết quả AudienceExport. rowCount không phụ thuộc vào số hàng được trả về trong phản hồi, tham số yêu cầu limit và tham số yêu cầu offset. Ví dụ: nếu một truy vấn trả về 175 hàng và bao gồm limit là 50 trong yêu cầu API, thì phản hồi sẽ chứa rowCount là 175 nhưng chỉ có 50 hàng.

Để tìm hiểu thêm về tham số phân trang này, hãy xem phần Phân trang.

Phạm vi uỷ quyền

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

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

AudienceRow

Thuộc tính giá trị phương diện cho hàng người dùng của đối tượng.

Biểu diễn dưới dạng JSON 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
Trường
dimensionValues[]

object (AudienceDimensionValue)

Mỗi thuộc tính giá trị phương diện cho một người dùng trong đối tượng. Một giá trị phương diện sẽ được thêm cho mỗi cột phương diện được yêu cầu.

AudienceDimensionValue

Giá trị của một phương diện.

Biểu diễn dưới dạng JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "value": string
  // End of mutually exclusive fields.
}
Trường
Một loại giá trị phương diện. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
value

string

Giá trị dưới dạng chuỗi nếu loại phương diện là chuỗi.
Kết thúc các trường xung khắc.