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 رقمًا يُستخدم لتحديد حساب الدفعات المرتبط بإعدادات الفوترة.

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

string

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

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

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

string

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

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

string

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

string

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