BillingSetup

إعداد الفوترة الذي يربط بين حساب الدفعات والمعلن. ويكون إعداد الفوترة مقتصرًا على معلن واحد.

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}
الحقول
resourceName

string

غير قابل للتغيير. اسم المورد لإعداد الفوترة. تكون أسماء موارد إعداد الفوترة بالصيغة التالية:

customers/{customerId}/billingSetups/{billing_setup_id}
status

enum (BillingSetupStatus)

النتائج فقط. حالة إعداد الفوترة.
paymentsAccountInfo

object (PaymentsAccountInfo)

غير قابل للتغيير. معلومات حساب الدفعات المرتبطة بإعدادات الفوترة هذه عند إعداد الفوترة، يتم استخدام هذه الطريقة للاشتراك باستخدام حساب دفعات جديد (ثم يجب عدم ضبط حساب الدفعات). عند الحصول على إعداد الفوترة، ستتم تعبئة هذا الحساب وحساب الدفعات.
id

string (int64 format)

النتائج فقط. رقم تعريف إعداد الفوترة.
paymentsAccount

string

غير قابل للتغيير. اسم المورد لحساب الدفعات المرتبط بإعداد الفوترة هذا. تكون أسماء مصادر الدفعات على النحو التالي:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} عند إعداد الفوترة، يتم استخدام هذه الطريقة للاشتراك باستخدام حساب دفعات حالي (ثم يجب عدم ضبط paymentsAccountInfo). عند ضبط إعدادات الفوترة، ستتم تعبئة هذا الحقل بالإضافة إلى paymentsAccountInfo.

حقل الاتحاد start_time عند إنشاء إعداد فوترة جديد، يكون هذا الإعداد ساري المفعول. ويكون NOW هو وقت البدء الوحيد المقبول إذا لم يكن لدى العميل أي عمليات إعداد موافَق عليها.

عند استرجاع إعداد فوترة حالي، يكون هذا هو وقت البدء المطلوب. ومع ذلك، إذا تمت الموافقة على الإعداد (اطّلِع على الحالة) بعد وقت البدء المطلوب، يكون هذا هو وقت الموافقة. يمكن أن تكون السمة "start_time" واحدة فقط مما يلي:
startDateTime

string

غير قابل للتغيير. وقت تاريخ البدء بتنسيق yyyy-MM-dd أو yyyy-MM-dd HH:mm:ss. يُسمح بتحديد وقت يقع في المستقبل فقط.
startTimeType

enum (TimeType)

غير قابل للتغيير. وقت البدء كنوع. يُسمح باستخدام NOW فقط.
حقل الاتحاد end_time عند انتهاء / انتهاء إعداد الفوترة يكون هذا إما دائمًا أو في وقت بدء إعداد الفوترة المُجدوَل التالي. يمكن أن تكون السمة "end_time" واحدة فقط مما يلي:
endDateTime

string

النتائج فقط. وقت تاريخ الانتهاء بتنسيق yyyy-MM-dd أو yyyy-MM-dd HH:mm:ss.
endTimeType

enum (TimeType)

النتائج فقط. وقت الانتهاء كنوع. إن القيمة الوحيدة الممكنة هي FOREVER.

BillingSetupStatus

الحالات المحتملة لإعداد الفوترة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
PENDING إعداد الفوترة في انتظار الموافقة.
APPROVED_HELD تمت الموافقة على إعداد الفوترة، ولكن لم تتم الموافقة على الميزانية الأولى المقابلة. ولا يمكن أن يحدث ذلك إلا لإعدادات الفوترة التي تم ضبطها لنظام الفواتير الشهرية.
APPROVED تمّت الموافقة على إعدادات الفوترة.
CANCELLED ألغى المستخدم إعداد الفوترة قبل الموافقة عليه.

PaymentsAccountInfo

حاوية معلومات حساب الدفعات المرتبطة بهذه الفوترة

تمثيل JSON 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
الحقول
paymentsAccountId

string

النتائج فقط. رقم تعريف مكوّن من 16 رقمًا يُستخدَم لتحديد حساب الدفعات المرتبط بإعداد الفوترة.

ويجب تمريره كسلسلة تضمّ شرطات، على سبيل المثال "3456-5678-9012-9012-1234".
paymentsAccountName

string

غير قابل للتغيير. اسم حساب الدفعات المرتبط بإعداد الفوترة.

يتيح ذلك للمستخدم تحديد اسم مهم لحساب الدفعات للمساعدة في تسوية الفواتير الشهرية.

ستتم طباعة هذا الاسم في الفواتير الشهرية.
paymentsProfileId

string

غير قابل للتغيير. رقم تعريف مكوّن من 12 رقمًا يُستخدَم لتحديد الملف الشخصي للدفع المرتبط بإعدادات الفوترة.

ويجب تمريره كسلسلة مع شرطات، على سبيل المثال "9012-5678-1234".
paymentsProfileName

string

النتائج فقط. اسم الملف الشخصي للدفع المرتبط بإعدادات الفوترة
secondaryPaymentsProfileId

string

النتائج فقط. يتوفّر معرّف الملف الشخصي الثانوي للدفع في مواقف غير معتادة، على سبيل المثال، عند ترتيب اتفاقية مسؤولية تسلسلية.