Method: customers.adsDataCustomers.getDataAccessBudget

بودجه دسترسی به داده را برای منبع داده تبلیغات درخواستی برای 366 روز گذشته بازیابی می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

ضروری. نام بودجه دسترسی به داده ها. قالب: مشتریان/{customerId}/adsDataCustomers/{adsDataCustomerId}/dataAccessBudget به عنوان مثال «customers/123/adsDataCustomers/456/dataAccessBudget».

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

وضعیت بودجه دسترسی به داده در هر تاریخ.

نمایندگی JSON
{
  "dataDayState": [
    {
      object (DataDayState)
    }
  ]
}
زمینه های
dataDayState[]

object ( DataDayState )

وضعیت بودجه بر اساس تاریخ

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

DataDayState

یک رکورد حاوی تاریخ و وضعیت بودجه برای این تاریخ.

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "budgetState": enum (BudgetState)
}
زمینه های
date

object ( Date )

تاریخ روز داده مربوط به این رکورد.

budgetState

enum ( BudgetState )

وضعیت بودجه برای این تاریخ داده.

بودجه دولت

وضعیت بودجه مربوط به یک روز داده.

Enums
BUDGET_STATE_UNSPECIFIED حالت نامشخص پیش فرض، این حالت قرار نیست به عنوان خروجی ظاهر شود.
BUDGET_STATE_ENOUGH_BUDGET بودجه مربوط به این روز داده در سطح عادی است.
BUDGET_STATE_BUDGET_IS_NEARLY_EXHAUSTED بودجه مربوط به این روز داده نزدیک به پایان است و برای جلوگیری از فرسودگی باید برخی بهینه سازی پرس و جو انجام شود.
BUDGET_STATE_OUT_OF_BUDGET بودجه مربوط به این روز داده تمام شده است و درخواست‌های مربوط به این روز داده ممکن است شکست بخورند.
،

بودجه دسترسی به داده را برای منبع داده تبلیغات درخواستی برای 366 روز گذشته بازیابی می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

ضروری. نام بودجه دسترسی به داده ها. قالب: مشتریان/{customerId}/adsDataCustomers/{adsDataCustomerId}/dataAccessBudget به عنوان مثال «customers/123/adsDataCustomers/456/dataAccessBudget».

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

وضعیت بودجه دسترسی به داده در هر تاریخ.

نمایندگی JSON
{
  "dataDayState": [
    {
      object (DataDayState)
    }
  ]
}
زمینه های
dataDayState[]

object ( DataDayState )

وضعیت بودجه بر اساس تاریخ

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

DataDayState

یک رکورد حاوی تاریخ و وضعیت بودجه برای این تاریخ.

نمایندگی JSON
{
  "date": {
    object (Date)
  },
  "budgetState": enum (BudgetState)
}
زمینه های
date

object ( Date )

تاریخ روز داده مربوط به این رکورد.

budgetState

enum ( BudgetState )

وضعیت بودجه برای این تاریخ داده.

بودجه دولت

وضعیت بودجه مربوط به یک روز داده.

Enums
BUDGET_STATE_UNSPECIFIED حالت نامشخص پیش فرض، این حالت قرار نیست به عنوان خروجی ظاهر شود.
BUDGET_STATE_ENOUGH_BUDGET بودجه مربوط به این روز داده در سطح عادی است.
BUDGET_STATE_BUDGET_IS_NEARLY_EXHAUSTED بودجه مربوط به این روز داده نزدیک به پایان است و برای جلوگیری از فرسودگی باید برخی بهینه سازی پرس و جو انجام شود.
BUDGET_STATE_OUT_OF_BUDGET بودجه مربوط به این روز داده تمام شده است و درخواست‌های مربوط به این روز داده ممکن است شکست بخورند.