Method: customers.adsDataCustomers.getDataAccessBudget

استرداد ميزانية الوصول إلى البيانات لمصدر بيانات الإعلانات المطلوب لآخر 366 يومًا.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
name

string

مطلوبة. اسم ميزانية الوصول إلى البيانات. التنسيق: customer/{customerId}/adsDataCustomers/{adsDataCustomerId}/dataAccessBudget، على سبيل المثال &#39؛customers/123/adsDataCustomers/456/dataAccessBudget&#39؛

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

حالة ميزانية الوصول إلى البيانات لكل تاريخ.

تمثيل 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)

حالة الميزانية لتاريخ البيانات هذا.

حالة الميزانية

حالة الميزانية المقابلة لأحد أيام البيانات.

عمليات التعداد
BUDGET_STATE_UNSPECIFIED الحالة غير المحددة التلقائية، من المفترض ألا تظهر هذه الحالة كإخراج.
BUDGET_STATE_ENOUGH_BUDGET الميزانية المقابلة لهذا اليوم من البيانات تقع ضمن المستوى العادي.
BUDGET_STATE_BUDGET_IS_NEARLY_EXHAUSTED اقتربت الميزانية المخصّصة ليوم البيانات هذا من النفاد، ويجب إجراء بعض عمليات تحسين طلبات البحث لتجنّب استنفادها.
BUDGET_STATE_OUT_OF_BUDGET تم استنفاد الميزانية المرتبطة بيوم البيانات هذا، وقد يتعذّر تنفيذ الطلبات التي تتضمّن يوم البيانات هذا.