Tập dữ liệu đại diện cho một vùng chứa phép chiếu cho các điểm dữ liệu. Chúng không có 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ể. Một điểm dữ liệu có thể được tìm thấy trong nhiều tập dữ liệu.
Để biết danh sách các phương thức của tài nguyên này, hãy xem ở cuối trang này.
Biểu thị 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ả | Ghi chú |
|---|---|---|---|
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 phần biểu thị một phần của tập dữ liệu này. 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 phần biểu thị một phần có thể của tập dữ liệu này. Thời gian tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. Phần phụ thuộc 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 nhận được một 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. Cung cấp giá trị này trong yêu cầu GET tiếp theo để trả về trang tiếp theo của các điểm dữ liệu trong tập dữ liệu này. | |
point[] |
list |
Danh sách một phần 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à hoàn chỉnh khi truy xuất một tập dữ liệu nhỏ và một phần khi đang vá một tập dữ liệu hoặc truy xuất mộ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 gần đây nhất điểm dữ liệu này được sửa đổi. Chỉ hữu ích trong trường hợp chúng tôi liệt kê các thay đổi về dữ liệu, thay vì trình bày 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 tập dữ liệu của một nguồn dữ liệu phái sinh, thì 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: không dựa vào trường này cho bất kỳ mục đích nào khác ngoài gỡ lỗi. Giá trị của trường này (nếu có) là một chi tiết triển khai và không được đảm bảo duy trì tính 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 từng 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 thứ tự mà trường được liệt kê trong loại dữ liệu được chỉ định trong một nguồn dữ liệu. Chỉ điền một trong các trường số nguyên và dấu phẩy động, tuỳ thuộc vào giá trị enum định dạng trong trường loại 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ị số 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 đồ. Không gian và đơn vị khoá hợp lệ cho giá trị tương ứng của mỗi mục nhập phải được ghi lại trong phần định nghĩa loại dữ liệu. Bạn nên giữ chìa khoá nhỏ bất cứ khi nào có thể. Các luồng dữ liệu có khoá lớn và tần suất dữ liệu cao có thể bị giảm tần suất 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. Bạn nên giữ chuỗi nhỏ bất cứ khi nào có thể. Các luồng dữ liệu có giá trị chuỗi lớn và tần suất dữ liệu cao có thể bị giảm mẫu. |
Phương thức
- 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à thời gian kết thúc trùng 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 có khoảng thời gian biểu thị 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 nằm trên một trong hai điểm cuối của tập dữ liệu, thì chỉ phần chồng chéo của điểm dữ liệu sẽ bị xoá. - nhận
- 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 và thời gian kết thúc tối đa đã chỉ định của tập dữ liệu. Cụ thể, bất kỳ điểm dữ liệu nào có thời gian bắt đầu nhỏ hơn hoặc bằng thời gian kết thúc tập dữ liệu và có thời gian kết thúc lớn hơn hoặc bằng thời gian bắt đầu 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. Tập dữ liệu không cần được tạo trước đó.
Tất cả các điểm trong tập dữ liệu đã cho sẽ được trả về bằng các lệnh gọi phụ để 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 mà không có dữ liệu hiện có nào được thay thế.