Konfigurasi penagihan adalah penautan tingkat akun antara akun Google Ads dan akun Pembayaran (juga dikenal sebagai konfigurasi invoice), yang secara efektif menentukan siapa yang ditagih untuk biaya yang dikeluarkan oleh anggaran akun konfigurasi penagihan. Setiap akun Pembayaran sesuai 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.
Konfigurasi penagihan berisi kolom
payments_account
dan
grup kolom
payments_account_info
yang mengidentifikasi Akun pembayaran yang digunakan, termasuk yang berikut:
payments_account_info.payments_account_id
: ID 16 digit yang digunakan untuk mengidentifikasi akun Pembayaran yang terkait dengan penyiapan penagihan.payments_account_info.payments_account_name
: Nama akun Pembayaran yang terkait dengan penyiapan penagihan. Nama ini dicetak di invoice bulanan.payments_account_info.payments_profile_id
: ID 12 digit yang digunakan untuk mengidentifikasi profil Pembayaran yang terkait dengan penyiapan penagihan.
Jika Akun pembayaran memenuhi syarat untuk penagihan gabungan, maka beberapa akun Google Ads dapat dikelompokkan dalam invoice yang sama dengan menyetel penyiapan penagihan untuk menggunakan Akun pembayaran pokok yang sama.
Membuat konfigurasi penagihan baru
Anda dapat menautkan konfigurasi penagihan baru ke Akun pembayaran yang sudah ada atau yang dibuat pada saat yang sama.
Menggunakan akun Pembayaran yang ada
Untuk menautkan dengan akun Pembayaran yang sudah ada, tetapkan
payments_account
ke
ID resource akun Pembayaran 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 dengan Akun pembayaran baru, tetapkan kolom berikut di
payments_account_info
(jangan tetapkan payments_account
):
Contoh berikut menunjukkan cara membuat konfigurasi penagihan baru dari ID Profil pembayaran yang ada. Seperti yang telah ditunjukkan sebelumnya, 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 konfigurasi penagihan pertama yang ditambahkan ke akun Google Ads, pelanggan akan secara efektif mendaftar untuk penagihan menggunakan profil Pembayaran yang dirujuk.
Status penyiapan penagihan
Instance BillingSetup
baru harus mendapatkan persetujuan sebelum diterapkan. Sebelum itu, status
mereka berada dalam status
PENDING
.
BillingSetup
dapat berada dalam salah satu
status
berikut:
Status Penyiapan Penagihan | Deskripsi |
---|---|
PENDING |
Menunggu persetujuan. |
APPROVED_HELD |
Disetujui, tetapi anggaran pertama yang sesuai belum disetujui. Hal ini hanya dapat terjadi untuk konfigurasi penagihan yang dikonfigurasi untuk invoice bulanan. |
APPROVED |
Penyiapan disetujui. |
CANCELLED |
Penyiapan dibatalkan oleh pengguna sebelum persetujuan. |
Mengambil penyiapan penagihan akun
Seperti sebagian besar entity lainnya di Google Ads API, BillingSetup
diambil dengan membuat kueri
GoogleAdsService.SearchStream
menggunakan kueri Bahasa Kueri Google Ads yang menentukan kolom mana 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 berlaku dapat
dibatalkan menggunakan operasi penghapusan. Konfigurasi penagihan hanya dapat dibatalkan jika status
-nya PENDING
atau jika APPROVED
untuk dimulai di masa mendatang.