Faturalandırma Kurulumu

Faturalandırma ayarı, bir Google Ads hesabı ile bir ödeme hesabı (fatura ayarı olarak da bilinir) arasındaki hesap düzeyinde bir bağlantıdır. Bu bağlantı, faturalandırma ayarının hesap bütçeleri tarafından yapılan harcamalar için kimin faturalandırılacağını etkili bir şekilde belirler. Her ödeme hesabı tek bir faturaya karşılık gelir.

Ödeme hesapları hakkında

Her BillingSetup, hesap bütçeleri tarafından karşılanan maliyetler için faturalandırılan bir ödeme hesabını tanımlar. Bu ödeme hesabı, nihayetinde ödemelerden sorumlu olan bir ödeme profili ile ilişkilidir.

Faturalandırma ayarları, hem bir payments_account alanı hem de kullanılan ödeme hesabını tanımlayan bir grup payments_account_info alanı içerir. Bu alanlardan bazıları şunlardır:

Bir ödeme hesabı birleştirilmiş faturalandırma için uygunsa faturalandırma ayarları aynı temel ödeme hesabını kullanacak şekilde ayarlanarak birden fazla Google Ads hesabı aynı faturada gruplandırılabilir.

Yeni faturalandırma ayarları oluşturma

Yeni faturalandırma ayarlarını mevcut ödeme hesaplarına veya aynı anda oluşturulan ödeme hesaplarına bağlayabilirsiniz.

Mevcut bir ödeme hesabını kullanma

Mevcut bir ödeme hesabıyla bağlantı oluşturmak için payments_account değerini geçerli bir ödeme hesabının kaynak kimliğine ayarlayın. Ancak payments_account_info öğesini değiştirmeyin.

Kullanılabilir ödeme hesaplarını PaymentsAccountService.ListPaymentsAccounts yöntemiyle listeleyebilirsiniz. Döndürülen PaymentsAccounts, kimlik doğrulama için kullandığınız yönetici hesabına bağlıdır.

Her PaymentsAccount için ödemeyi yapan yöneticisinin kimliği paying_manager_customer alanında yer alır.

Yeni bir ödeme hesabı kullanma

Yeni bir ödeme hesabıyla bağlantı oluşturmak için payments_account_info bölümünde aşağıdaki alanları ayarlayın (payments_account alanını ayarlamayın):

Aşağıdaki örnekte, mevcut bir ödeme profili kimliğinden nasıl yeni bir faturalandırma ayarı oluşturulacağı gösterilmektedir. Daha önce belirtildiği gibi, bu işlemle My New Payments Account adlı yeni bir ödeme hesabı da oluşturulur.

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);
}

Bu, bir Google Ads hesabına eklenen ilk faturalandırma ayarıysa bu işlem, müşteriyi referans verilen ödeme profilini kullanarak faturalandırmaya kaydeder.

Faturalandırma ayarlarının durumu

Yeni BillingSetup örnekleri, etkinleştirilmeden önce onaylanmalıdır. Bu süre zarfında status, PENDING durumunda kalır.

BillingSetup aşağıdakilerden birinde olabilir status:

Faturalandırma Ayarı Durumu Açıklama
PENDING Onay bekleniyor.
APPROVED_HELD Onaylanmış ancak ilgili ilk bütçe onaylanmamış. Bu durum yalnızca aylık faturalandırma için yapılandırılmış faturalandırma ayarlarında ortaya çıkabilir.
APPROVED Kurulum onaylandı.
CANCELLED Kurulum, onaylanmadan önce kullanıcı tarafından iptal edildi.

Hesabın faturalandırma ayarlarını alma

Google Ads API'deki diğer çoğu öğe gibi, BillingSetup de döndürülecek alanları belirten bir Google Ads Sorgu Dili sorgusu kullanılarak GoogleAdsService.SearchStream sorgulanarak getirilir.

BillingSetup referansı aldıktan sonra, Hesap Bütçesi bölümünde açıklandığı şekilde AccountBudgetProposal oluşturmak için kullanabilirsiniz.

Beklemedeki bir faturalandırma ayarını iptal etme

Henüz yürürlüğe girmemiş bir BillingSetup, kaldırma işlemi kullanılarak iptal edilebilir. Faturalandırma ayarları yalnızca status durumundaysa PENDING veya gelecekteki bir tarihte APPROVED durumundaysa iptal edilebilir.