BillingSetup

Penyiapan penagihan, yang mengaitkan akun pembayaran dan pengiklan. Penyiapan penagihan khusus untuk satu pengiklan.

Representasi 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.
}
Kolom
resourceName

string

Tidak dapat diubah. Nama resource penyiapan penagihan. Nama resource BillingSetup memiliki bentuk:

customers/{customerId}/billingSetups/{billing_setup_id}

status

enum (BillingSetupStatus)

Hanya output. Status penyiapan penagihan.

paymentsAccountInfo

object (PaymentsAccountInfo)

Tidak dapat diubah. Informasi akun pembayaran yang terkait dengan konfigurasi penagihan ini. Saat menyiapkan penagihan, parameter ini digunakan untuk mendaftar dengan akun pembayaran baru (dan paymentsAccount tidak boleh ditetapkan). Saat menyiapkan penagihan, akun ini dan akun pembayaran akan terisi.

id

string (int64 format)

Hanya output. ID penyiapan penagihan.

paymentsAccount

string

Tidak dapat diubah. Nama resource akun pembayaran yang terkait dengan penyiapan penagihan ini. Nama resource pembayaran memiliki format:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} Saat menyiapkan penagihan, parameter ini digunakan untuk mendaftar dengan akun pembayaran yang ada (dan paymentsAccountInfo tidak boleh ditetapkan). Saat mendapatkan penyiapan penagihan, ini dan paymentsAccountInfo akan diisi.

Kolom union start_time. Saat membuat penyiapan penagihan baru, ini adalah saat penyiapan akan diterapkan. SEKARANG adalah satu-satunya waktu mulai yang dapat diterima jika pelanggan tidak memiliki penyiapan yang disetujui.

Saat mengambil penyiapan penagihan yang ada, ini adalah waktu mulai yang diminta. Namun, jika penyiapan disetujui (lihat status) setelah waktu mulai yang diminta, waktu ini adalah waktu persetujuan. start_time hanya dapat berupa salah satu dari hal berikut:

startDateTime

string

Tidak dapat diubah. Waktu tanggal mulai dalam format yyyy-MM-dd atau yyyy-MM-dd HH:mm:ss. Hanya waktu mendatang yang diizinkan.

startTimeType

enum (TimeType)

Tidak dapat diubah. Waktu mulai sebagai jenis. Hanya SEKARANG yang diizinkan.

Kolom union end_time. Saat penyiapan penagihan berakhir/telah berakhir. Tanggal ini SELAMANYA atau waktu mulai penyiapan penagihan terjadwal berikutnya. end_time hanya dapat berupa salah satu dari berikut:
endDateTime

string

Hanya output. Waktu tanggal akhir dalam format yyyy-MM-dd atau yyyy-MM-dd HH:mm:ss.

endTimeType

enum (TimeType)

Hanya output. Waktu berakhir sebagai jenis. Satu-satunya nilai yang mungkin adalah SELAMANYA.

BillingSetupStatus

Kemungkinan status BillingSetup.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai yang ditampilkan. Merepresentasikan nilai yang tidak diketahui dalam versi ini.
PENDING Penyiapan penagihan sedang menunggu persetujuan.
APPROVED_HELD Penyiapan penagihan telah disetujui, tetapi anggaran pertama yang sesuai belum disetujui. Hal ini hanya dapat terjadi untuk penyiapan penagihan yang dikonfigurasi untuk invoice bulanan.
APPROVED Penyiapan penagihan telah disetujui.
CANCELLED Penyiapan penagihan dibatalkan oleh pengguna sebelum persetujuan.

PaymentsAccountInfo

Penampung informasi akun pembayaran untuk penagihan ini.

Representasi JSON
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
Kolom
paymentsAccountId

string

Hanya output. ID 16 digit yang digunakan untuk mengidentifikasi akun pembayaran yang terkait dengan konfigurasi penagihan.

ID ini harus diteruskan sebagai string dengan tanda hubung, misalnya, "1234-5678-9012-3456".

paymentsAccountName

string

Tidak dapat diubah. Nama akun pembayaran yang dikaitkan dengan penyiapan penagihan.

Hal ini memungkinkan pengguna menentukan nama yang bermakna untuk akun pembayaran guna membantu merekonsiliasi invoice bulanan.

Nama ini akan dicetak di invoice bulanan.

paymentsProfileId

string

Tidak dapat diubah. ID 12 digit yang digunakan untuk mengidentifikasi profil pembayaran yang terkait dengan penyiapan penagihan.

ID ini harus diteruskan sebagai string dengan tanda hubung, misalnya, "1234-5678-9012".

paymentsProfileName

string

Hanya output. Nama profil pembayaran yang terkait dengan penyiapan penagihan.

secondaryPaymentsProfileId

string

Hanya output. ID profil pembayaran sekunder muncul dalam situasi yang tidak umum, misalnya, saat perjanjian kewajiban terutang telah diatur.