Method: properties.reportTasks.query

Truy xuất nội dung của tác vụ báo cáo. Sau khi yêu cầu reportTasks.create, bạn có thể truy xuất nội dung báo cáo khi báo cáo HOẠT ĐỘNG. Phương thức này sẽ trả về lỗi nếu trạng thái của tác vụ báo cáo không phải là ACTIVE. Phản hồi truy vấn sẽ trả về các giá trị hàng và cột dạng bảng của báo cáo.

Yêu cầu HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query

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

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Tên nguồn báo cáo. Định dạng properties/{property}/reportTasks/{report}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có 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 trong báo cáo. 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, đặt độ lệch bằng 0; yêu cầu đầu tiên trả về limit đầu tiên của các hàng. Yêu cầu thứ hai đặt độ lệch với 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ề thông 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 cần trả về từ báo cáo. Nếu không chỉ định, hàm sẽ trả về 10.000 hàng. API 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. Số hàng có sẵn cho QueryReportTaskRequest được giới hạn thêm bởi giới hạn của ReportTask được liên kết. Truy vấn có thể truy xuất tối đa hàng ReportTask.limit. Ví dụ: nếu ReportTask có giới hạn là 1.000, thì yêu cầu reportTasks.query có offset=900 và limit=500 sẽ trả về tối đa 100 hàng.

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

Nội dung phản hồi

Nội dung báo cáo tương ứng với tác vụ báo cáo.

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
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "totals": [
    {
      object (Row)
    }
  ],
  "maximums": [
    {
      object (Row)
    }
  ],
  "minimums": [
    {
      object (Row)
    }
  ],
  "rowCount": integer,
  "metadata": {
    object (ResponseMetaData)
  }
}
Trường
dimensionHeaders[]

object (DimensionHeader)

Mô tả các cột phương diện. Số lượng khía cạnh tiêu đề và thứ tự của các tiêu đề kích thước khớp với các phương diện có trong các hàng.

metricHeaders[]

object (MetricHeader)

Mô tả các cột chỉ số. Số lượng MetricsHeader và thứ tự của MetricsHeaders khớp với chỉ số có trong các hàng.

rows[]

object (Row)

Các hàng gồm các kiểu kết hợp giá trị phương diện và giá trị chỉ số trong báo cáo.

totals[]

object (Row)

Tổng giá trị của các chỉ số, nếu được yêu cầu.

maximums[]

object (Row)

Giá trị tối đa của các chỉ số nếu được yêu cầu.

minimums[]

object (Row)

Giá trị tối thiểu của chỉ số nếu được yêu cầu.

rowCount

integer

Tổng số hàng trong kết quả truy vấn.

metadata

object (ResponseMetaData)

Siêu dữ liệu cho báo cáo.

Phạm vi uỷ quyền

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

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

ResponseMetaData

Siêu dữ liệu của phản hồi chứa thông tin bổ sung về nội dung báo cáo.

Biểu diễn dưới dạng JSON
{
  "dataLossFromOtherRow": boolean,
  "schemaRestrictionResponse": {
    object (SchemaRestrictionResponse)
  },
  "currencyCode": string,
  "timeZone": string,
  "emptyReason": string,
  "subjectToThresholding": boolean
}
Trường
dataLossFromOtherRow

boolean

Nếu đúng, hãy cho biết một số nhóm kết hợp phương diện được cuộn vào hàng "(other)". Điều này có thể xảy ra đối với các báo cáo có số lượng giá trị riêng biệt cao.

Thông số siêu dữ liệu dataThusFromOtherRow được điền dựa trên bảng dữ liệu tổng hợp dùng trong báo cáo. Thông số này sẽ được điền chính xác, bất kể bộ lọc và giới hạn trong báo cáo.

Ví dụ: hàng (other) có thể bị loại bỏ khỏi báo cáo vì yêu cầu chứa bộ lọc trên sessionSource = google. Thông số này sẽ vẫn được điền nếu dữ liệu bị mất ở hàng khác có trong dữ liệu tổng hợp đầu vào được dùng để tạo báo cáo này.

Để tìm hiểu thêm, hãy xem bài viết Giới thiệu về hàng (other) và tính năng lấy mẫu dữ liệu.

schemaRestrictionResponse

object (SchemaRestrictionResponse)

Mô tả các quy định hạn chế trong giản đồ được chủ động thực thi khi tạo báo cáo này. Để tìm hiểu thêm, hãy xem bài viết Quản lý quyền truy cập và quy định hạn chế về dữ liệu.

currencyCode

string

Mã đơn vị tiền tệ được sử dụng trong báo cáo này. Dùng khi định dạng các chỉ số đơn vị tiền tệ như purchaseRevenue để trình bày trực quan. Nếu CurrencyCode được chỉ định trong yêu cầu, thì tham số phản hồi này sẽ lặp lại tham số yêu cầu; nếu không, tham số phản hồi này là CurrencyCode hiện tại của thuộc tính.

Mã đơn vị tiền tệ là chuỗi mã hoá các loại đơn vị tiền tệ theo tiêu chuẩn ISO 4217 (https://en.wikipedia.org/wiki/ISO_4217); ví dụ: "USD", "EUR", "JPY". Để tìm hiểu thêm, hãy xem https://support.google.com/analytics/answer/9796179.

timeZone

string

Múi giờ hiện tại của cơ sở lưu trú. Được dùng để diễn giải các phương diện theo thời gian như hourminute. Được định dạng dưới dạng chuỗi từ cơ sở dữ liệu Múi giờ IANA (https://www.iana.org/time-zones); ví dụ: "America/New_xyz" hoặc "Châu Á/Tokyo".

emptyReason

string

Nếu bạn chỉ định lý do trống, báo cáo sẽ trống vì lý do này.

subjectToThresholding

boolean

Nếu subjectToThresholding đúng, báo cáo này phải tuân theo ngưỡng và chỉ trả về dữ liệu đáp ứng ngưỡng tổng hợp tối thiểu. Một yêu cầu có thể bị áp dụng ngưỡng và không có dữ liệu nào xuất hiện trong báo cáo. Điều này xảy ra khi tất cả dữ liệu đều vượt quá ngưỡng. Để tìm hiểu thêm, hãy xem bài viết Ngưỡng dữ liệuGiới thiệu về Thông tin nhân khẩu học và mối quan tâm.

SchemaRestrictionResponse

Các quy định hạn chế trong giản đồ đã được chủ động thực thi khi tạo báo cáo này. Để tìm hiểu thêm, hãy xem bài viết Quản lý quyền truy cập và quy định hạn chế về dữ liệu.

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

object (ActiveMetricRestriction)

Tất cả các quy định hạn chế đã được chủ động thực thi khi tạo báo cáo. Ví dụ: purchaseRevenue luôn có loại hạn chế REVENUE_DATA. Tuy nhiên, giới hạn phản hồi đang hoạt động này chỉ được điền nếu vai trò tuỳ chỉnh của người dùng không cho phép truy cập vào REVENUE_DATA.

ActiveMetricRestriction

Một chỉ số bị hạn chế tích cực khi tạo báo cáo.

Biểu diễn dưới dạng JSON
{
  "restrictedMetricTypes": [
    enum (RestrictedMetricType)
  ],
  "metricName": string
}
Trường
restrictedMetricTypes[]

enum (RestrictedMetricType)

Lý do hạn chế của chỉ số này.

metricName

string

Tên của chỉ số bị hạn chế.

RestrictedMetricType

Những danh mục dữ liệu mà bạn có thể bị hạn chế xem trên một số tài sản GA4.

Enum
RESTRICTED_METRIC_TYPE_UNSPECIFIED Loại không xác định.
COST_DATA Các chỉ số về chi phí, chẳng hạn như adCost.
REVENUE_DATA Các chỉ số về doanh thu, chẳng hạn như purchaseRevenue.