Konfigurasi penagihan

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:

Jika Akun pembayaran memenuhi syarat untuk penagihan gabungan, beberapa akun Google Ads dapat dikelompokkan dalam invoice yang sama dengan menyetel konfigurasi 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 ada, tetapkan payments_account ke nama resource akun Pembayaran yang valid (misalnya, customers/{customer_id}/paymentsAccounts/{payments_account_id}). Namun, jangan ubah payments_account_info.

Anda dapat mencantumkan akun Pembayaran yang tersedia dengan metode PaymentsAccountService.ListPaymentsAccounts. Objek PaymentsAccount yang ditampilkan bergantung pada akun pengelola yang Anda gunakan untuk autentikasi.

Untuk setiap PaymentsAccount, nama resource 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 ditunjukkan sebelumnya, tindakan ini juga akan membuat akun Pembayaran baru dengan nama My New Payments Account.

BillingSetup billingSetup =
    BillingSetup.newBuilder()
        .setPaymentsAccountInfo(
            PaymentsAccountInfo.newBuilder()
                .setPaymentsAccountName("My New Payments Account")
                .setPaymentsProfileId("1234-5678-9012")
                .build())
        .setStartTimeType(TimeTypeEnum.TimeType.NOW)
        .build();

BillingSetupOperation operation =
    BillingSetupOperation.newBuilder().setCreate(billingSetup).build();

try (BillingSetupServiceClient billingSetupServiceClient =
    googleAdsClient.getBillingSetupServiceClient()) {
  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(
          Long.toString(customerId), operation);
}

Jika ini adalah konfigurasi penagihan pertama yang ditambahkan ke akun Google Ads, pelanggan akan secara efektif mendaftar penagihan menggunakan profil Pembayaran yang dirujuk.

Status konfigurasi penagihan

Instance BillingSetup baru harus disetujui sebelum berlaku. Sebelum itu, status mereka berada dalam status PENDING.

BillingSetup dapat memiliki salah satu nilai status berikut:

BillingSetupStatus 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 konfigurasi penagihan akun

Seperti sebagian besar entity lainnya di Google Ads API, BillingSetup diambil dengan membuat kueri GoogleAdsService.Search atau GoogleAdsService.SearchStream menggunakan kueri Bahasa Kueri Google Ads (GAQL) yang menentukan kolom mana yang akan ditampilkan:

SELECT
  billing_setup.resource_name,
  billing_setup.id,
  billing_setup.status,
  billing_setup.payments_account,
  billing_setup.payments_account_info.payments_account_id,
  billing_setup.payments_account_info.payments_account_name,
  billing_setup.payments_account_info.payments_profile_id,
  billing_setup.payments_account_info.payments_profile_name,
  billing_setup.start_date_time,
  billing_setup.end_date_time,
  billing_setup.end_time_type
FROM billing_setup

Setelah mendapatkan referensi ke BillingSetup, Anda dapat menggunakannya untuk membuat AccountBudgetProposal seperti yang dijelaskan dalam Anggaran akun.

Membatalkan konfigurasi penagihan yang tertunda

BillingSetup yang belum berlaku dapat dibatalkan dengan mengirim BillingSetupOperation dengan kolom remove yang ditetapkan ke nama resource penyiapan penagihan (customers/{customer_id}/billingSetups/{billing_setup_id}). Penyiapan penagihan hanya dapat dibatalkan jika status-nya PENDING atau jika APPROVED untuk dimulai di masa mendatang.

Sebelumnya
Ringkasan penagihan
Berikutnya
Anggaran akun