Penyiapan Penagihan

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:

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.