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 untuk biaya yang timbul berdasarkan anggaran akun penyiapan 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 dikaitkan 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 sedang digunakan, termasuk hal berikut:
payments_account_info.payments_account_id
: ID 16 digit yang digunakan untuk mengidentifikasi Akun pembayaran yang terkait dengan konfigurasi penagihan.payments_account_info.payments_account_name
: Nama akun Pembayaran yang terkait dengan penyiapan penagihan. Nama ini dicetak pada faktur bulanan.payments_account_info.payments_profile_id
: ID 12 digit yang digunakan untuk mengidentifikasi Profil pembayaran yang terkait dengan konfigurasi penagihan.
Jika akun Payments memenuhi syarat untuk penagihan gabungan, beberapa akun Google Ads dapat dikelompokkan dalam invoice yang sama dengan menetapkan konfigurasi penagihannya agar menggunakan akun Payments pokok yang sama.
Membuat konfigurasi penagihan baru
Anda dapat menautkan konfigurasi penagihan baru ke akun Payments yang sudah ada atau akun yang dibuat secara bersamaan.
Menggunakan akun Pembayaran yang ada
Untuk menautkan akun Pembayaran yang sudah ada, tetapkan payments_account
ke ID resource akun Pembayaran yang valid. Namun, jangan mengubah
payments_account_info
.
Anda dapat menampilkan daftar 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
pembayaran-nya ada di
kolom
paying_manager_customer
.
Menggunakan akun Pembayaran baru
Untuk menautkan akun Pembayaran baru, tetapkan kolom berikut di payments_account_info
(jangan tetapkan payments_account
):
Contoh di bawah menunjukkan cara membuat konfigurasi penagihan baru dari ID profil pembayaran yang sudah 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 konfigurasi penagihan pertama yang ditambahkan ke akun Google Ads, tindakan ini akan secara efektif mendaftarkan pelanggan untuk penagihan menggunakan Profil pembayaran yang direferensikan.
Status penyiapan penagihan
Instance BillingSetup
baru harus
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 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 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 adalah
PENDING
atau jika APPROVED
dimulai pada waktu mendatang.