Tập dữ liệu đại diện cho một vùng chứa chiếu cho các điểm dữ liệu. Họ không mang theo bất kỳ thông tin nào của riêng mình. Các tập dữ liệu đại diện cho một tập hợp các điểm dữ liệu từ một nguồn dữ liệu cụ thể. Bạn có thể tìm thấy một điểm dữ liệu trong nhiều tập dữ liệu.
Để biết danh sách phương thức cho tài nguyên này, hãy xem phần cuối của trang này.
Biểu diễn tài nguyên
{ "minStartTimeNs": long, "maxEndTimeNs": long, "dataSourceId": string, "point": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "nextPageToken": string }
Tên tài sản | Giá trị | Nội dung mô tả | Lưu ý |
---|---|---|---|
dataSourceId |
string |
Mã luồng dữ liệu của nguồn dữ liệu đã tạo các điểm trong tập dữ liệu này. | |
maxEndTimeNs |
long |
Thời gian kết thúc lớn nhất của tất cả các điểm dữ liệu trong bản trình bày một phần này của tập dữ liệu. Thời gian tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. Giá trị này cũng phải khớp với phần thứ hai của giá trị nhận dạng tập dữ liệu. | |
minStartTimeNs |
long |
Thời gian bắt đầu nhỏ nhất của tất cả các điểm dữ liệu trong bản trình bày một phần này của tập dữ liệu. Thời gian tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. Giá trị này cũng phải khớp với phần đầu tiên của giá trị nhận dạng tập dữ liệu. | |
nextPageToken |
string |
Mã thông báo này sẽ được đặt khi người dùng nhận được tập dữ liệu theo yêu cầu GET và tập dữ liệu quá lớn nên không thể đưa vào một phản hồi. Hãy cung cấp giá trị này trong yêu cầu GET tiếp theo để trả về trang điểm tiếp theo trong tập dữ liệu này. | |
point[] |
list |
Một phần danh sách các điểm dữ liệu có trong tập dữ liệu, được sắp xếp theo endTimeNanos. Danh sách này được coi là đầy đủ khi truy xuất một tập dữ liệu nhỏ và một phần khi vá một tập dữ liệu hoặc truy xuất tập dữ liệu quá lớn để đưa vào một phản hồi. | |
point[].computationTimeMillis |
long |
KHÔNG SỬ DỤNG TRƯỜNG NÀY. Thuộc tính này sẽ bị bỏ qua và không được lưu trữ. | |
point[].dataTypeName |
string |
Loại dữ liệu xác định định dạng của các giá trị trong điểm dữ liệu này. | |
point[].endTimeNanos |
long |
Thời gian kết thúc của khoảng thời gian được biểu thị bằng điểm dữ liệu này, tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. | |
point[].modifiedTimeMillis |
long |
Cho biết lần sửa đổi điểm dữ liệu gần đây nhất. Chỉ hữu ích trong các bối cảnh mà chúng tôi đang liệt kê các thay đổi về dữ liệu, thay vì thể hiện trạng thái hiện tại của dữ liệu. | |
point[].originDataSourceId |
string |
Nếu điểm dữ liệu nằm trong một tập dữ liệu cho nguồn dữ liệu phái sinh, trường này sẽ được điền sẵn mã luồng nguồn dữ liệu đã tạo điểm dữ liệu ban đầu. CẢNH BÁO: đừng dựa vào trường này cho bất kỳ mục đích nào khác ngoài việc gỡ lỗi. Giá trị của trường này (nếu được đặt) là thông tin chi tiết về cách triển khai và không đảm bảo sẽ nhất quán. |
|
point[].rawTimestampNanos |
long |
Dấu thời gian thô từ SensorEvent ban đầu. | |
point[].startTimeNanos |
long |
Thời gian bắt đầu của khoảng thời gian được biểu thị bằng điểm dữ liệu này, tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. | |
point[].value[] |
list |
Giá trị của mỗi trường loại dữ liệu cho điểm dữ liệu. Theo dự kiến, mỗi giá trị tương ứng với một trường loại dữ liệu sẽ xuất hiện theo đúng thứ tự mà trường đó được liệt kê trong loại dữ liệu quy định trong nguồn dữ liệu. Chỉ điền sẵn một trong các trường số nguyên và dấu phẩy động, tùy thuộc vào giá trị enum định dạng trong trường loại dữ liệu của nguồn dữ liệu. |
|
point[].value[].fpVal |
double |
Giá trị dấu phẩy động. Khi đặt giá trị này, bạn không được đặt các giá trị khác. | |
point[].value[].intVal |
integer |
Giá trị nguyên. Khi đặt giá trị này, bạn không được đặt các giá trị khác. | |
point[].value[].mapVal[] |
list |
Giá trị bản đồ. Bạn phải ghi lại không gian khóa và đơn vị hợp lệ cho giá trị tương ứng của mỗi mục trong định nghĩa loại dữ liệu. Bạn nên giữ chìa khóa nhỏ bất cứ khi nào có thể. Các luồng dữ liệu có khóa lớn và tần suất dữ liệu cao có thể bị lấy mẫu. | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
Giá trị dấu phẩy động. | |
point[].value[].stringVal |
string |
Giá trị chuỗi. Khi đặt giá trị này, bạn không được đặt các giá trị khác. Chuỗi phải được giữ nhỏ bất cứ khi nào có thể. Những luồng dữ liệu có giá trị chuỗi lớn và tần suất dữ liệu cao có thể bị lấy mẫu. |
Phương pháp
- xóa
- Thực hiện xoá tất cả các điểm dữ liệu có thời gian bắt đầu và kết thúc trùng lặp với phạm vi thời gian do mã tập dữ liệu chỉ định. Đối với hầu hết các loại dữ liệu, toàn bộ điểm dữ liệu sẽ bị xoá. Đối với các loại dữ liệu mà khoảng thời gian
đại diện cho một giá trị nhất quán (chẳng hạn như
com.google.activity.segment
) và một điểm dữ liệu trải dài vào một trong hai điểm của tập dữ liệu, thì chỉ phần trùng lặp của điểm dữ liệu sẽ bị xoá. - tải
- Trả về một tập dữ liệu chứa tất cả các điểm dữ liệu có thời gian bắt đầu và thời gian kết thúc trùng lặp với phạm vi thời gian bắt đầu tối thiểu của tập dữ liệu đã chỉ định và thời gian kết thúc tối đa. Cụ thể, mọi điểm dữ liệu có thời gian bắt đầu nhỏ hơn hoặc bằng thời gian kết thúc của tập dữ liệu và thời gian kết thúc lớn hơn hoặc bằng thời gian bắt đầu của tập dữ liệu.
- bản vá
- Thêm các điểm dữ liệu vào một tập dữ liệu. Bạn không cần phải tạo tập dữ liệu trước đây.
Tất cả điểm trong tập dữ liệu cho trước sẽ được trả về bằng các lệnh gọi tiếp theo để truy xuất tập dữ liệu này. Các điểm dữ liệu có thể thuộc về nhiều tập dữ liệu.
Phương thức này không sử dụng ngữ nghĩa của bản vá: các điểm dữ liệu được cung cấp chỉ được chèn vào, không có dữ liệu hiện có nào được thay thế.