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

تغییرناپذیر. نام منبع تنظیم صورت‌حساب. نام منابع BillingSetup به شکل زیر است:

customers/{customerId}/billingSetups/{billing_setup_id}

status

enum ( BillingSetupStatus )

فقط خروجی وضعیت تنظیم صورت‌حساب.

paymentsAccountInfo

object ( PaymentsAccountInfo )

تغییرناپذیر. اطلاعات حساب پرداخت مرتبط با این تنظیم صورت‌حساب. هنگام تنظیم صورت‌حساب، از این برای ثبت‌نام با یک حساب پرداخت جدید استفاده می‌شود (و سپس paysAccount نباید تنظیم شود). هنگام دریافت راه‌اندازی صورت‌حساب، این و PaysAccount پر می‌شوند.

id

string ( int64 format)

فقط خروجی شناسه تنظیم صورت‌حساب.

paymentsAccount

string

تغییرناپذیر. نام منبع حساب پرداخت مرتبط با این تنظیم صورت‌حساب. نام منابع پرداخت به شکل زیر است:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} هنگام تنظیم صورت‌حساب، از این مورد برای ثبت‌نام با یک حساب پرداخت موجود استفاده می‌شود (و سپس paysAccountInfo نباید تنظیم شود). هنگام دریافت تنظیم صورت‌حساب، این و PaysAccountInfo پر می‌شوند.

start_time فیلد اتحادیه هنگام ایجاد یک تنظیم صورت‌حساب جدید، این زمانی است که تنظیم باید اعمال شود. در صورتی که مشتری تنظیمات تایید شده ای نداشته باشد، NOW تنها زمان شروع قابل قبول است.

هنگام واکشی یک تنظیم صورت‌حساب موجود، این زمان شروع درخواستی است. با این حال، اگر تنظیم پس از زمان شروع درخواستی تأیید شد (وضعیت را ببینید)، این زمان تأیید است. start_time می تواند تنها یکی از موارد زیر باشد:

startDateTime

string

تغییرناپذیر. زمان تاریخ شروع در قالب yyyy-MM-dd یا yyyy-MM-dd HH:mm:ss. فقط زمان آینده مجاز است.

startTimeType

enum ( TimeType )

تغییرناپذیر. زمان شروع به عنوان یک نوع. فقط در حال حاضر مجاز است.

end_time فیلد اتحادیه وقتی تنظیم صورت‌حساب به پایان می‌رسد/پایان می‌آید. این یا برای همیشه یا زمان شروع تنظیم صورتحساب برنامه ریزی شده بعدی است. end_time می تواند تنها یکی از موارد زیر باشد:
endDateTime

string

فقط خروجی زمان تاریخ پایان در قالب yyyy-MM-dd یا yyyy-MM-dd HH:mm:ss.

endTimeType

enum ( TimeType )

فقط خروجی زمان پایان به عنوان یک نوع. تنها مقدار ممکن FOREVER است.

BillingSetupStatus

وضعیت های احتمالی یک BillingSetup.

Enums
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

فقط خروجی شناسه نمایه پرداخت‌های ثانویه در موقعیت‌های غیرمعمول وجود دارد، به‌عنوان مثال، زمانی که یک قرارداد بدهی متوالی تنظیم شده است.