REST Resource: projects.locations.reportConfigs.reportDetails

資源：ReportDetail

說明 ReportDetail 物件的訊息。ReportDetail 代表報表設定產生的商品目錄報表中繼資料。

JSON 表示法 
{
  "name": string,
  "snapshotTime": string,
  "reportPathPrefix": string,
  "shardsCount": string,
  "status": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "targetDatetime": {
    object (DateTime)
  },
  "reportMetrics": {
    object (Metrics)
  }
}
欄位
name

string

資源名稱。格式：projects/{projectNumber}/locations/{location}/reportConfigs/{report-config-id}/reportDetails/{report-detail-id}。
snapshotTime

string (Timestamp format)

快照時間。系統會參照目前的所有廣告空間報表資料。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
reportPathPrefix

string

每個報表區塊的物件名稱前置字串。除了 extension 和 shard_id 之外，這個前置字串包含完整的字首。舉例來說，如果 destinationPath 是 {report-config-id}/dt={datetime}，則分割區物件名稱為 gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_5.csv，reportPathPrefix 欄位的值則為 gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_。
shardsCount

string (int64 format)

為廣告空間報表產生的總片段數。
status

object (Status)

庫存報表的狀態。
labels

map (key: string, value: string)

標籤為鍵/值組合

包含 "key": value 組合清單的物件。範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
targetDatetime

object (DateTime)

產生庫存報表的日期和時間。系統會自動填入這個欄位。targetDatetime 的時間部分一律為 0。
reportMetrics

object (Metrics)

庫存報表的指標。

DateTime

代表民用時間 (或偶爾的實際時間)。

這個類型可透過以下幾種方式表示公元時間：

  • 當 utcOffset 已設定且 timeZone 未設定時：日曆日期的民用時間，與世界標準時間有特定偏移。
  • 當 timeZone 已設值，但 utcOffset 未設值時：特定時區中某個日曆日的民用時間。
  • 如果未設定 timeZone 或 utcOffset：以當地時間表示的曆法日民用時間。

日期以西曆為主。

如果年、月或日為 0，系統會認為 DateTime 分別沒有特定年、月或日。

如果已設定所有日期和時間欄位，且已設定 time_offset oneof 的任一情況，則也可使用此類型來表示實際時間。建議您改用 Timestamp 訊息來表示實際時間。如果您的用途也想儲存使用者的時區，可以使用其他欄位。

這類型比某些應用程式所需的彈性更高。請務必記錄並驗證應用程式的限制。

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
欄位
year

integer

(非必要) 日期的年份。必須為 1 到 9999；如要指定不含年份的日期時間，請輸入 0。
month

integer

(非必要) 月份。必須為 1 到 12；如要指定不含月份的日期時間，請輸入 0。
day

integer

(非必要) 當月第幾日。必須為 1 到 31，並屬於有效的年和月；如果只指定日期時間，請輸入 0。
hours

integer

(非必要) 一天中的小時，採用 24 小時制。值應介於 0 到 23 之間，預設值為 0 (午夜)。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。
minutes

integer

(非必要) 一天中，每小時內的分鐘。值必須介於 0 到 59 之間，預設值為 0。
seconds

integer

(非必要) 在當下時間中，該分鐘的秒數。值必須介於 0 到 59 之間，預設為 0。如果 API 允許閏秒，則可允許值為 60。
nanos

integer

(非必要) 秒數的小數，以奈秒為單位。值必須介於 0 到 999,999,999 之間，預設值為 0。
聯集欄位 time_offset。(非必要) 指定 DateTime 的 UTC 偏移量或時區。請謹慎選擇，因為時區資料日後可能會變更 (例如，某個國家/地區修改夏令時間開始/結束日期，而受影響範圍內的未來日期/時間已儲存)。如果省略，系統會將 DateTime 視為當地時間。time_offset 只能是下列其中一項：
utcOffset

string (Duration format)

世界標準時間時差。必須是整數秒，介於 -18 小時和 +18 小時之間。舉例來說，如果 UTC 偏移量為 -4:00，則會以 { seconds: -14400 } 表示。

以秒為單位的時間長度，最多可有 9 個小數位數，結尾為「s」，例如："3.5s"。
timeZone

object (TimeZone)

時區。

TimeZone

代表 IANA 時區資料庫中的時區。

JSON 表示法 
{
  "id": string,
  "version": string
}
欄位
id

string

IANA 時區資料庫時區。例如「America/New_York」。
version

string

(非必要) IANA 時區資料庫版本號碼。例如「2019a」。

指標

與產生報表相關聯的指標。

JSON 表示法 
{
  "processedRecordsCount": string
}
欄位
processedRecordsCount

string (int64 format)

包含在資產清單報表中的 Cloud Storage 物件數量。

方法

get

 取得指定專案中現有的特定地點庫存報表。

list

 列出指定位置中指定專案的庫存報表。