Hướng dẫn này đề cập đến các tài nguyên khắc phục sự cố RTB, cho phép bạn truy cập theo cách có lập trình
đặt giá thầu theo thời gian thực cũng được hiển thị thông qua
Công cụ Đột phá RTB trong
Giao diện người dùng của Authorized Buyers. Các thiết bị này bao gồm bidders.filterSets
, bidders.accounts.filterSets
và
tất cả tài nguyên dưới chúng theo thứ tự phân cấp.
Bằng cách sử dụng các chỉ số từ tài nguyên khắc phục sự cố RTB, bạn có thể có được thông tin chi tiết về các cơ hội bị bỏ lỡ để nhận được các lượt hiển thị có thể giúp bạn tối ưu hoá chiến dịch đặt giá thầu theo thời gian thực.
Điều chỉnh cấu trúc và kiểu API
Tài nguyên khắc phục sự cố RTB giới thiệu một số thay đổi để chỉ rõ quyền sở hữu và quyền truy cập, cung cấp khả năng kiểm soát chi tiết hơn đối với dữ liệu mà API trả về và phù hợp hơn với Các phương pháp thiết kế API của Google.
Tài nguyên ở cấp bên đặt giá thầu và cấp tài khoản
Các tài nguyên được cấu trúc trong cả bidders
và bidders.accounts
. Các tham số này cho phép bạn chỉ định
liệu lệnh gọi API có nhắm mục tiêu bên đặt giá thầu (còn gọi là tài khoản mẹ hay không) và tất cả
tài khoản con hoặc tài khoản Authorized Buyers cá nhân. Trong bối cảnh RTB
Khắc phục sự cố, các tài nguyên có cấu trúc trong bidders.filterSets
sẽ trả về các chỉ số tổng hợp
cho bên đặt giá thầu nhất định và tất cả các tài khoản con được liên kết. Ngược lại, những người dùng trong
bidders.accounts.filterSets
sẽ chỉ trả về các chỉ số cho tài khoản được chỉ định, bất kể
cho dù đó là tài khoản bên đặt giá thầu hay tài khoản con.
Lưu ý: Tài khoản uỷ quyền đặt giá thầu cho một người mua khác không phải là tài khoản bên đặt giá thầu và
do đó không thể truy cập vào tài nguyên ở cấp bên đặt giá thầu. Ngoài ra, tài khoản không phải của bên đặt giá thầu cũng không thể
truy cập vào impressionMetrics
, filteredBidResponses
, bidResponseErrors
ở cấp tài khoản và
Tài nguyên bidResponsesWithoutBids
.
Ra mắt tên tài nguyên dưới dạng giá trị nhận dạng duy nhất
Tên tài nguyên được dùng làm nhận dạng duy nhất thay vì mã nhận dạng số nguyên hoặc chuỗi. Khi tạo một thực thể mới của một đối tượng cụ thể loại tài nguyên này, bây giờ bạn phải chỉ định một tương đối tài nguyên bằng cách sử dụng đường dẫn URI của tài nguyên, theo sau là mã nhận dạng tài nguyên ưu tiên. Chiến lược phát hành đĩa đơn sau đây là ví dụ về các tên có liên quan cho các tài nguyên Khắc phục sự cố RTB:
Tài nguyên | Ví dụ về tên |
---|---|
bidders.filterSets | bidders/12345678/filterSets/fset_1 |
bidders.accounts.filterSets | bidders/12345678/accounts/87654321/filterSets/fset_2 |
Lưu ý: Mã tài nguyên được chỉ định cho bidders
trong tên phải là mã của bên đặt giá thầu
Mã tài khoản Authorized Buyers. Đối với accounts
, mã nhận dạng tài nguyên phải là mã tài khoản của một trong hai
bên đặt giá thầu hoặc tài khoản con do bên đặt giá thầu đó quản lý. Nếu bạn không biết Authorized Buyers nào
được liên kết với Tài khoản Google của bạn, bạn có thể sử dụng
accounts.list để tìm chúng.
Nhóm bộ lọc
Nhóm bộ lọc thể hiện các lựa chọn lọc có sẵn và có thể tạo được ở cấp bên đặt giá thầu hoặc cấp tài khoản. URL này được dùng để lọc danh sách kết quả khắc phục sự cố RTB để truy xuất chỉ số cho chiến dịch đặt giá thầu theo thời gian thực.
Bộ lọc được áp dụng khi truy xuất các chỉ số là giao điểm của từng bộ lọc trong dữ liệu được chỉ định
tập hợp bộ lọc. Các bộ lọc danh sách, chẳng hạn như platforms
, được hiểu là hợp nhất của từng mục trong danh sách.
Bộ lọc cấp tài khoản và bên đặt giá thầu khác nhau và chỉ truy cập được từ cấp mà chúng được tạo—bất kể tài khoản được dùng để tạo chúng là gì. Bên đặt giá thầu và tài khoản con chia sẻ các tập hợp bộ lọc được tạo ở cấp tài khoản, trong khi chỉ bên đặt giá thầu mới có thể truy cập vào các tài nguyên ở cấp bên đặt giá thầu. Bảng sau đây tóm tắt cách bên đặt giá thầu và tài khoản con có thể truy cập vào các tài nguyên ở một trong hai cấp độ:
bidders.filterSets | bidders.accounts.filterSets | |
---|---|---|
Tài khoản bên đặt giá thầu | Lệnh gọi API chỉ ảnh hưởng đến các tập hợp bộ lọc cấp bên đặt giá thầu. | Lệnh gọi API chỉ ảnh hưởng đến các nhóm bộ lọc cấp tài khoản. |
Tài khoản con | Lệnh gọi API này sẽ trả về một phản hồi lỗi. | Lệnh gọi API chỉ ảnh hưởng đến các nhóm bộ lọc cấp tài khoản. |
Tạo một nhóm bộ lọc
Khi tạo tập hợp bộ lọc, bạn phải chỉ định phạm vi thời gian là relativeDateRange
,
absoluteDateRange
hoặc realtimeTimeRange
. Khi truy xuất chỉ số,
chế độ mặc định là áp dụng cho tất cả dữ liệu được cung cấp trong toàn bộ phạm vi thời gian. Nếu bạn muốn nhận
bảng chi tiết chuỗi thời gian trong phạm vi thời gian, bạn có thể chỉ định timeSeriesGranularity
để chỉ định khoảng thời gian HOURLY
hoặc DAILY
.
Nếu chỉ yêu cầu nhóm bộ lọc trong một khoảng thời gian ngắn, bạn có thể đặt giá trị isTransient
thành true
. Điều này cho biết nhóm bộ lọc là tạm thời, có nghĩa là nhóm sẽ không được duy trì vô thời hạn. Các tập hợp bộ lọc tạm thời sẽ có sẵn trong ít nhất một giờ sau khi tạo, nhưng cuối cùng sẽ bị xoá. Theo mặc định, các nhóm bộ lọc không phải là tạm thời.
Ví dụ ở cấp bên đặt giá thầu
Để tạo tập hợp bộ lọc cấp bên đặt giá thầu mới, hãy gửi yêu cầu POST
đến URI tài nguyên bidders.filterSets
có định dạng sau:
https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets
Cảnh báo: Bộ bộ lọc cấp bên đặt giá thầu không thể lọc theo mã mẫu quảng cáo hoặc mã giao dịch. Nếu chỉ định các bộ lọc này khi tạo tập hợp bộ lọc cấp bên đặt giá thầu, bạn sẽ nhận được phản hồi lỗi.
Yêu cầuDưới đây là ví dụ về yêu cầu POST
tạo tập hợp bộ lọc cấp bên đặt giá thầu không tạm thời mới:
POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets Authorization: Bearer access token here Content-Type: application/json { "name": "bidders/12345678/filterSets/bidder-fs", "format": "DISPLAY", "environment": "APP", "platforms": ["TABLET", "MOBILE"], "absoluteDateRange": { "startDate": { "month": 11, "day": 26, "year": 2017 }, "endDate": { "month": 12, "day": 3, "year": 2017 } }, "timeSeriesGranularity": "DAILY" }
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái 200 OK. Nội dung phản hồi sẽ bao gồm tài nguyên nhóm bộ lọc đã tạo, giống với nhóm bộ lọc được gửi trong yêu cầu.
Ví dụ ở cấp tài khoản
Để tạo tập hợp bộ lọc cấp tài khoản mới, hãy gửi yêu cầu POST
đến
URI tài nguyên bidders.accounts.filterSets
có định dạng như sau:
https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets
Lưu ý: Mã nhận dạng tài nguyên được chỉ định cho accounts
có thể
là mã tài khoản của bất kỳ tài khoản Authorized Buyers nào mà bên đặt giá thầu có thể truy cập
tài khoản được chỉ định trong URI, bao gồm cả tài khoản bên đặt giá thầu.
Dưới đây là ví dụ về một yêu cầu POST
tạo một tập hợp bộ lọc cấp tài khoản không tạm thời mới:
POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets Authorization: Bearer access token here Content-Type: application/json { "name": "bidders/12345678/accounts/87654321/filterSets/account-fs", "format": "VIDEO", "environment": "WEB", "platforms": ["DESKTOP"], "absoluteDateRange": { "startDate": { "month": 11, "day": 26, "year": 2017 }, "endDate": { "month": 12, "day": 3, "year": 2017 } }, "timeSeriesGranularity": "DAILY" }
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái 200 OK. Nội dung phản hồi sẽ bao gồm tài nguyên nhóm bộ lọc đã tạo. Tài nguyên này sẽ giống với nhóm bộ lọc được gửi trong yêu cầu.
Tải một nhóm bộ lọc
Phương thức get chỉ có thể lấy tập hợp bộ lọc ở chính cấp mà nó được tạo. Ví dụ: trình đặt giá thầu
tài khoản nên sử dụng bidders.accounts.filterSets.get
để truy xuất nhóm bộ lọc được tạo trong tài khoản
thay vì phương thức bidders.filterSets.get
.
Cấp bên đặt giá thầu
Bạn có thể truy xuất bộ lọc cấp bên đặt giá thầu bằng cách gửi yêu cầu HTTP GET đến URI tài nguyên bidders.filterSets
có định dạng như sau:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}
Ví dụ:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK
và tập hợp bộ lọc được truy xuất:
{ "name": "bidders/12345678/filterSets/bidder-fs", "format": "DISPLAY", "environment": "APP", "platforms": ["TABLET", "MOBILE"], "absoluteDateRange": { "startDate": { "month": 11, "day": 26, "year": 2017 }, "endDate": { "month": 12, "day": 3, "year": 2017 } }, "timeSeriesGranularity": "DAILY" }
Cấp tài khoản
Bạn có thể truy xuất tập hợp bộ lọc cấp tài khoản bằng cách gửi yêu cầu HTTP GET
đến URI tài nguyên bidders.accounts.filterSets
có định dạng như sau:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}
Ví dụ:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái HTTP 200 OK
và tập hợp bộ lọc được truy xuất:
{ "name": "bidders/12345678/accounts/87654321/filterSets/account-fs", "format": "VIDEO", "environment": "WEB", "platforms": ["DESKTOP"], "absoluteDateRange": { "startDate": { "month": 11, "day": 26, "year": 2017 }, "endDate": { "month": 12, "day": 3, "year": 2017 } }, "timeSeriesGranularity": "DAILY" }
Liệt kê các nhóm bộ lọc
Phương thức danh sách sẽ chỉ trả về các tập hợp bộ lọc có thể truy cập từ cấp mà nó đang được gọi.
Ví dụ: tài khoản bên đặt giá thầu sẽ không thấy các tập hợp bộ lọc được tạo cho chính tài khoản đó thông qua
bidders.accounts.filterSets.create
khi gọi bidders.filterSets.list
.
Cấp bên đặt giá thầu
Bạn có thể truy xuất tất cả tập hợp bộ lọc cấp bên đặt giá thầu cho một bên đặt giá thầu nhất định bằng cách gửi HTTP GET
yêu cầu đến URI tài nguyên bidders.filtersets
có định dạng sau:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets
Dưới đây là ví dụ liệt kê tất cả các bộ bộ lọc cấp bên đặt giá thầu cho bên đặt giá thầu có mã tài khoản là 12345678:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets
{ "filterSets": [{ "filterSetId": "99994", "name": "bidders/12345678/filterSets/test-b-1", "relativeDateRange": { "durationDays": 30 } }, { "realtimeTimeRange": { "startTimeStamp": "2017-11-15T12:30:30.072831583Z" }, "filterSetId": "99995", "name": "bidders/12345678/filterSets/test-b-2", "timeSeriesGranularity": "HOURLY" }, { "absoluteDateRange": { "endDate": { "day": 12, "month": 3, "year": 2017 }, "startDate": { "day": 26, "month": 11, "year": 2017 } }, "filterSetId": "99996", "name": "bidders/12345678/filterSets/bidder-fs", "timeSeriesGranularity": "DAILY", "platforms": ["TABLET", "MOBILE"], "environment": "APP", "format": "DISPLAY" } ] }
Cấp tài khoản
Bạn có thể truy xuất tất cả các nhóm bộ lọc cấp tài khoản của một tài khoản nhất định bằng cách gửi một HTTP GET
yêu cầu đến URI tài nguyên bidders.accounts.filtersets
có định dạng sau:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets
Dưới đây là ví dụ liệt kê tất cả các nhóm bộ lọc cấp tài khoản cho một tài khoản con có mã tài khoản là 87654321:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets
{ "filterSets": [{ "realtimeTimeRange": { "startTimeStamp": "2017-11-19T04:24:43.252893487Z" }, "filterSetId": "99997", "name": "bidders/12345678/accounts/87654321/filterSets/test-a-1", "timeSeriesGranularity": "DAILY" }, { "absoluteDateRange": { "endDate": { "day": 3, "month": 12, "year": 2017 }, "startDate": { "day": 26, "month": 11, "year": 2017 } }, "filterSetId": "99998", "name": "bidders/12345678/accounts/87654321/filterSets/account-fs", "timeSeriesGranularity": "DAILY", "platforms": ["DESKTOP"], "environment": "WEB", "format": "VIDEO" } ] }
Xóa tập hợp bộ lọc
Bạn có thể sử dụng phương thức delete
để xoá mọi tập hợp bộ lọc không tạm thời không
cần thiết lâu hơn. Bộ lọc chỉ có thể xoá các tập hợp bộ lọc có thể truy cập từ cấp mà bộ lọc đang được gọi;
ví dụ: tài khoản bên đặt giá thầu không thể xóa tập hợp bộ lọc được tạo bằng bidders.accounts.filterSets.create
cùng với bidders.filterSets.delete
.
Cấp bên đặt giá thầu
Bạn có thể xoá tập hợp bộ lọc cấp bên đặt giá thầu cho một tài khoản nhất định bằng cách gửi yêu cầu HTTP DELETE
vào URI tài nguyên bidders.filtersets
có định dạng sau:
DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}
Dưới đây là ví dụ về cách xoá tập hợp bộ lọc cấp bên đặt giá thầu:
DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/test-b-2
Nếu thành công, nội dung yêu cầu sẽ trống. Bạn sẽ không thể truy cập vào nhóm bộ lọc được chỉ định nữa.
Cấp tài khoản
Bạn có thể xoá tập hợp bộ lọc cấp tài khoản cho một tài khoản cụ thể bằng cách gửi một HTTP DELETE
yêu cầu đến URI tài nguyên bidders.accounts.filtersets
có định dạng sau:
DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}
Dưới đây là ví dụ về cách xoá nhóm bộ lọc cấp tài khoản:
DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/test-a-1
Nếu thành công, nội dung yêu cầu sẽ trống. Bạn sẽ không thể truy cập vào nhóm bộ lọc được chỉ định nữa.
Truy xuất chỉ số khắc phục sự cố RTB
Tất cả tài nguyên khắc phục sự cố RTB dùng để nhận chỉ số hoạt động theo cách tương tự nhau—chúng có
phương thức duy nhất để liệt kê các chỉ số cho tập hợp bộ lọc được chỉ định thông qua đường dẫn filterSetName
. Nhóm bộ lọc được chỉ định sẽ xác định bộ lọc và cài đặt nào sẽ được áp dụng khi
truy vấn các chỉ số. Việc gọi các tài nguyên này từ cấp bên đặt giá thầu sẽ trả về các chỉ số tổng hợp
từ tài khoản người đặt giá thầu và tất cả các tài khoản con được liên kết, trong khi lệnh gọi từ cấp tài khoản
sẽ chỉ trả về các chỉ số cho tài khoản cá nhân.
Chỉ số giá thầu
Tài nguyên bidMetrics
dùng để truy xuất các chỉ số được đo lường trong
số lượng giá thầu. Ví dụ: bạn có thể sử dụng chỉ số này để xác định tổng số giá thầu của mình trên một
phạm vi thời gian nhất định và số lượng quảng cáo không được lọc khỏi phiên đấu giá, giành được hiển thị,
Giống như tất cả các tài nguyên khắc phục sự cố RTB khác được dùng để thu thập chỉ số, tài nguyên này chỉ có phương thức list
.
Liệt kê các chỉ số giá thầu ở cấp bên đặt giá thầu
Bạn có thể liệt kê các chỉ số giá thầu ở cấp bên đặt giá thầu cho một nhóm bộ lọc nhất định bằng cách gửi một HTTP GET
yêu cầu đến URI tài nguyên bidders.filtersets.bidMetrics
có định dạng sau:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}/bidMetrics
Dưới đây là ví dụ về các chỉ số giá thầu ở cấp bên đặt giá thầu liệt kê:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs/bidMetrics
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái 200 OK
và nội dung chứa các hàng chỉ số cho các phương diện và độ chi tiết được chỉ định.
{ "bidMetricsRows": [{ "bids": { "value": "6160" }, "bidsInAuction": { "value": "5698" }, "billedImpressions": { "value": "1196" }, "impressionsWon": { "value": "2920" }, "measurableImpressions": { "value": "1160" }, "rowDimensions": { "timeInterval": { "endTime": "2017-11-29T08:00:00Z", "startTime": "2017-11-28T08:00:00Z" } }, "viewableImpressions": { "value": "683" } }, { "bids": { "value": "104288" }, "bidsInAuction": { "value": "94016" }, "billedImpressions": { "value": "99" }, "impressionsWon": { "value": "125" }, "measurableImpressions": { "value": "94" }, "rowDimensions": { "timeInterval": { "endTime": "2017-11-30T08:00:00Z", "startTime": "2017-11-29T08:00:00Z" } }, "viewableImpressions": { "value": "87" } }, { "bids": { "value": "3999" }, "bidsInAuction": { "value": "3631" }, "billedImpressions": { "value": "618" }, "impressionsWon": { "value": "1819" }, "measurableImpressions": { "value": "604" }, "rowDimensions": { "timeInterval": { "endTime": "2017-12-01T08:00:00Z", "startTime": "2017-11-30T08:00:00Z" } }, "viewableImpressions": { "value": "369" } }, { "bids": { "value": "15" }, "bidsInAuction": { "value": "3" }, "billedImpressions": {}, "impressionsWon": { "value": "3" }, "measurableImpressions": {}, "rowDimensions": { "timeInterval": { "endTime": "2017-12-02T08:00:00Z", "startTime": "2017-12-01T08:00:00Z" } }, "viewableImpressions": {} } ] }
Lưu ý: Mọi trường được đặt thành 0 cho một chỉ số nhất định sẽ không xuất hiện trong nội dung phản hồi.
Chỉ số billedImpressions
và measurableImpressions
trống ở trên
chỉ ra rằng cả giá trị và phương sai của các giá trị này được đặt bằng 0.
Cảnh báo: Đối với mọi thông tin chi tiết về dữ liệu trong câu trả lời, câu trả lời sẽ không
bao gồm các hàng nếu chúng không chứa ít nhất một chỉ số khác 0. Ví dụ: khi một
timeSeriesGranularity
đã được chỉ định, phản hồi sẽ không bao gồm hàng cho bất kỳ
timeInterval
trong phạm vi thời gian được chỉ định của nhóm bộ lọc, trong đó tất cả các chỉ số đều bằng 0.
Liệt kê các chỉ số giá thầu ở cấp tài khoản
Bạn có thể liệt kê các chỉ số giá thầu cấp tài khoản cho một nhóm bộ lọc nhất định bằng cách gửi một HTTP GET
yêu cầu đến URI tài nguyên bidders.accounts.filtersets.bidMetrics
, trong đó có
định dạng sau:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}/bidMetrics
Dưới đây là ví dụ liệt kê các chỉ số giá thầu cấp tài khoản:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs/bidMetrics
Nếu yêu cầu thành công, máy chủ sẽ phản hồi bằng mã trạng thái 200 OK
và nội dung chứa các hàng chỉ số cho các phương diện và độ chi tiết được chỉ định.
{ "bidMetricsRows": [{ "bids": { "value": "1748" }, "bidsInAuction": { "value": "1421" }, "billedImpressions": { "value": "301" }, "impressionsWon": { "value": "915" }, "measurableImpressions": { "value": "298" }, "rowDimensions": { "timeInterval": { "endTime": "2017-12-01T08:00:00Z", "startTime": "2017-11-30T08:00:00Z" } }, "viewableImpressions": { "value": "172" } }, { "bids": { "value": "6" }, "bidsInAuction": { "value": "2" }, "billedImpressions": {}, "impressionsWon": { "value": "1" }, "measurableImpressions": {}, "rowDimensions": { "timeInterval": { "endTime": "2017-12-02T08:00:00Z", "startTime": "2017-12-01T08:00:00Z" } }, "viewableImpressions": {} } ] }
Lưu ý: Mọi trường được đặt thành 0 cho một chỉ số nhất định sẽ không xuất hiện trong nội dung phản hồi. Chiến lược phát hành đĩa đơn
các chỉ số billedImpressions
và measurableImpressions
trống ở trên cho biết
cả giá trị và phương sai của các giá trị này đều được đặt thành 0.
Cảnh báo: Đối với mọi thông tin chi tiết về dữ liệu trong câu trả lời, câu trả lời sẽ không bao gồm
các hàng nếu chúng không chứa ít nhất một chỉ số khác 0. Ví dụ: khi một
timeSeriesGranularity
đã được chỉ định, phản hồi sẽ không bao gồm hàng cho bất kỳ
timeInterval
trong phạm vi thời gian được chỉ định của nhóm bộ lọc, trong đó tất cả các chỉ số đều bằng 0.