BillingSetup

Penyiapan penagihan, yang mengaitkan akun pembayaran dan pengiklan. Penyiapan penagihan ditujukan 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 penyiapan penagihan ini. Saat menyiapkan penagihan, metode ini digunakan untuk mendaftar dengan akun pembayaran baru (dan akun payments tidak boleh ditetapkan). Saat menyiapkan penagihan, Akun ini dan pembayaran akan diisi.
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 bentuk:

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

Kolom union start_time. Saat membuat penyiapan penagihan baru, penyiapan inilah yang akan diterapkan. NOW 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, berarti ini adalah waktu persetujuan. start_time hanya dapat berupa salah satu dari yang 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 NOW yang diizinkan.
Kolom union end_time. Saat penyiapan penagihan berakhir / berakhir. Waktu ini bisa SELAMANYA atau waktu mulai penyiapan penagihan terjadwal berikutnya. end_time hanya ada berupa salah satu diantara 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 FOREVER.

BillingSetupStatus

Kemungkinan status BillingSetup.

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

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 penyiapan penagihan.

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

string

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

Dengan begitu, pengguna dapat menentukan nama yang bermakna untuk akun pembayaran guna membantu rekonsiliasi 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.

Nilai 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 ada dalam situasi yang tidak umum, misalnya, saat perjanjian kewajiban terutang telah dibuat.