Method: customers.adsDataCustomers.getDataAccessBudget

針對過去 366 天的資料，擷取所要求廣告資料來源的資料存取預算。

HTTP 要求

GET https://adsdatahub.googleapis.com/v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要，資料存取預算的名稱。格式：customer/{customerId}/adsDataCustomers/{adsDataCustomerId}/dataAccessBudget，例如 'customers/123/adsDataCustomers/456/dataAccessBudget'.

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

每日的資料存取預算狀態。

JSON 表示法 
{
  "dataDayState": [
    {
      object (DataDayState)
    }
  ]
}
欄位
dataDayState[]

object (DataDayState)

預算 (依日期顯示)。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adsdatahub

資料日狀態

包含此日期預算和狀態的記錄。

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "budgetState": enum (BudgetState)
}
欄位
date

object (Date)

與這筆記錄對應的資料日。
budgetState

enum (BudgetState)

此資料日期的預算狀態。

預算狀況

對應資料日期的預算狀態。

列舉
BUDGET_STATE_UNSPECIFIED 預設的未指定狀態，不應將此狀態顯示為輸出內容。
BUDGET_STATE_ENOUGH_BUDGET 此資料日對應的預算落在正常範圍內。
BUDGET_STATE_BUDGET_IS_NEARLY_EXHAUSTED 與這個資料日相對應的預算即將用盡，因此必須執行某些查詢最佳化作業，以免耗盡預算。
BUDGET_STATE_OUT_OF_BUDGET 與這個資料日期相對應的預算已用盡，因此涉及此資料日的查詢可能會失敗。