- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- AudienceRow
- AudienceDimensionValue
- Hãy làm thử!
Truy xuất dữ liệu xuất về đối tượng gồm những người dùng. Sau khi tạo đối tượng, người dùng sẽ không thể xuất ngay lập tức. Đầu tiên, bạn cần gửi yêu cầu đến audienceExports.create
để tạo đối tượng xuất đối tượng. Thứ hai, phương thức này được dùng để truy xuất người dùng trong dữ liệu xuất đối tượng.
Hãy xem bài viết Tạo Xuất đối tượng để tìm hiểu giới thiệu về tính năng Xuất đối tượng kèm theo các ví dụ.
Các đối tượng trong Google Analytics 4 cho phép bạn tạo phân khúc người dùng theo những cách có ý nghĩa đối với công việc kinh doanh của bạn. Để tìm hiểu thêm, hãy xem https://support.google.com/analytics/answer/9267572.
API Xuất đối tượng có một số phương thức ở giai đoạn alpha và các phương thức khác có độ ổn định ở giai đoạn thử nghiệm beta. Mục đích của chúng tôi là cải tiến các phương pháp thử nghiệm độ ổn định sau khi nhận được một số ý kiến phản hồi và áp dụng. Để đưa ra ý kiến phản hồi về API này, hãy hoàn thành biểu mẫu Phản hồi về API Xuất đối tượng của Google Analytics.
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 |
Bắt buộc. Tên của tệp xuất đối tượng để truy xuất người dùng. Định dạng |
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 |
Không bắt buộc. Số lượng 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, đặt giá trị bù trừ bằng 0; yêu cầu đầu tiên sẽ trả về Để tìm hiểu thêm về thông số phân trang này, hãy xem nội dung Phân trang. |
limit |
Không bắt buộc. Số hàng cần trả về. Nếu bạn không chỉ định thì hệ thống sẽ trả về 10.000 hàng. API sẽ 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. API cũng có thể trả về ít hàng hơn so với Để tìm hiểu thêm về thông số phân trang này, hãy xem nội dung Phân trang. |
Nội dung phản hồi
Danh sách người dùng trong tính năng 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 ( |
Trường | |
---|---|
audienceRows[] |
Các hàng cho mỗi người dùng trong một dữ liệu 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 |
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 về đối tượng trong câu trả lờ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 |
Tổng số hàng trong kết quả AudienceExport. Để tìm hiểu thêm về thông số phân trang này, hãy xem nội dung 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 ( |
Trường | |
---|---|
dimensionValues[] |
Mỗi thuộc tính giá trị phương diện cho một người dùng thuộc đối tượng. Một giá trị phương diện sẽ được thêm vào 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 |
---|
{ // Union field |
Trường | |
---|---|
Trường kết hợp one_value . Một loại giá trị phương diện. one_value chỉ có thể là một trong những trạng thái sau đây: |
|
value |
Giá trị dưới dạng chuỗi nếu loại phương diện là chuỗi. |