- 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 (Hàng đối tượng)
- AudienceDimensionValue
- Hãy làm thử!
Truy xuất danh sách đối tượng của người dùng. Sau khi tạo đối tượng, người dùng không thể xuất hiện ngay lập tức để đăng trang thông tin. Trước tiên, bạn cần gửi yêu cầu đến audienceLists.create
để tạo danh sách đối tượng gồm người dùng. Sau đó, thứ hai, phương thức này được dùng để truy xuất người dùng trong danh sách đối tượng.
Xem bài viết Tạo Danh sách đối tượng để biết giới thiệu về Danh sách đối tượng kèm theo các ví dụ.
Đối tượng trong Google Analytics 4 cho phép bạn phân chia người dùng thành những phân khúc quan trọng đố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.
Phương thức này hiện có độ ổn định ở giai đoạn beta tại audienceExports.query. Để 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/v1alpha/{name=properties/*/audienceLists/*}: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 danh sách đố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 độ lệch bằng 0; yêu cầu đầu tiên trả về Để tìm hiểu thêm về thông số phân trang này, hãy xem phần Phân trang. |
limit |
Không bắt buộc. Số hàng cần trả về. 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. API cũng có thể trả về ít hàng hơn Để 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
Danh sách người dùng trong một danh sách đố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 từng người dùng trong một danh sách đối tượng. Số 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. |
audienceList |
Dữ liệu cấu hình về AudienceList đ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 AudienceList này tương ứng với các cột trong AudienceRows. |
rowCount |
Tổng số hàng trong kết quả AudienceList. Để tìm hiểu thêm về thông 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 đây:
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 là đố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 là đố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 |
---|
{ // Union field |
Trường | |
---|---|
Trường 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: |
|
value |
Giá trị ở dạng chuỗi nếu loại phương diện là chuỗi. |