Penyiapan penagihan adalah penautan tingkat akun antara akun Google Ads dan Akun pembayaran (juga dikenal sebagai penyiapan invoice), yang secara efektif menentukan siapa yang ditagih atas biaya yang dikeluarkan oleh anggaran akun konfigurasi penagihan. Setiap akun Pembayaran terkait dengan satu invoice.
Tentang Akun pembayaran
Setiap BillingSetup
mengidentifikasi akun Pembayaran yang ditagih untuk biaya yang dikeluarkan oleh anggaran akunnya. Akun
pembayaran ini terkait dengan Profil
pembayaran yang pada akhirnya
bertanggung jawab atas tagihan.
Penyiapan penagihan berisi kolom payments_account
dan grup kolom
payments_account_info
yang mengidentifikasi Akun pembayaran yang digunakan, termasuk kolom berikut:
payments_account_info.payments_account_id
: ID 16 digit yang digunakan untuk mengidentifikasi akun Payments yang terkait dengan penyiapan penagihan.payments_account_info.payments_account_name
: Nama akun Pembayaran yang terkait dengan penyiapan penagihan. Nama ini dicetak pada invoice bulanan.payments_account_info.payments_profile_id
: ID 12 digit yang digunakan untuk mengidentifikasi Profil pembayaran yang terkait dengan penyiapan penagihan.
Jika akun Payments memenuhi syarat untuk penagihan gabungan, beberapa akun Google Ads dapat dikelompokkan dalam invoice yang sama dengan menetapkan penyiapan penagihannya agar menggunakan akun Payments dasar yang sama.
Membuat penyiapan penagihan baru
Anda dapat menautkan konfigurasi penagihan baru ke akun Payments yang sudah ada atau akun yang dibuat secara bersamaan.
Menggunakan akun Pembayaran yang sudah ada
Untuk menautkan dengan akun Payments yang sudah ada, tetapkan
payments_account
ke
ID resource akun Payments yang valid. Namun, jangan ubah
payments_account_info
.
Anda dapat mencantumkan akun pembayaran yang tersedia dengan
metode
PaymentsAccountService.ListPaymentsAccounts
. PaymentsAccounts
yang ditampilkan bergantung pada akun pengelola yang Anda gunakan untuk autentikasi.
Untuk setiap PaymentsAccount
, ID pengelola
pembayarannya ada di kolom
paying_manager_customer
.
Menggunakan akun Pembayaran baru
Untuk menautkan akun Payments yang baru, tetapkan kolom berikut di payments_account_info
(jangan tetapkan payments_account
):
Contoh di bawah menunjukkan cara membuat penyiapan penagihan baru dari ID profil Pembayaran
yang ada. Seperti yang ditunjukkan di atas, tindakan ini juga akan membuat
akun Pembayaran baru dengan nama My New Payments Account
.
BillingSetup bsetup = BillingSetup.newBuilder()
.setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
.setPaymentsAccountName("My New Payments Account")
.setPaymentsProfileId("1234-5678-9012")
.build())
.setStartTimeType(TimeType.NOW)
.build();
BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();
try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
.getBillingSetupServiceClient()) {
MutateBillingSetupResponse response =
billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}
Jika ini adalah penyiapan penagihan pertama yang ditambahkan ke akun Google Ads, tindakan ini akan secara efektif mendaftarkan pelanggan untuk menerima penagihan menggunakan Profil pembayaran yang direferensikan.
Status penyiapan penagihan
Instance BillingSetup
baru dapat
disetujui sebelum diterapkan. Hingga saat itu, status
-nya
berada dalam
status
PENDING
.
BillingSetup
dapat berada di salah satu status
berikut:
Status Penyiapan Penagihan | Deskripsi |
---|---|
PENDING |
Menunggu persetujuan. |
APPROVED_HELD |
Disetujui tetapi anggaran pertama yang terkait belum. Hal ini hanya dapat terjadi pada penyiapan penagihan yang dikonfigurasi untuk invoice bulanan. |
APPROVED |
Penyiapan disetujui. |
CANCELLED |
Penyiapan dibatalkan oleh pengguna sebelum persetujuan. |
Mengambil konfigurasi penagihan akun
Seperti sebagian besar entitas lain di Google Ads API, BillingSetup
diambil dengan membuat kueri
GoogleAdsService.SearchStream
menggunakan kueri Bahasa Kueri Google Ads yang menentukan kolom yang akan ditampilkan.
Setelah mendapatkan referensi ke BillingSetup
,
Anda dapat menggunakannya untuk membuat
AccountBudgetProposal
seperti yang dijelaskan dalam
Anggaran Akun.
Membatalkan penyiapan penagihan yang tertunda
BillingSetup
yang belum diterapkan dapat
dibatalkan menggunakan operasi penghapusan. Penyiapan penagihan hanya dapat dibatalkan jika
status
-nya
PENDING
atau jika APPROVED
akan dimulai pada masa mendatang.