Faturalandırma ayarları

Faturalandırma ayarları, bir Google Ads hesabı ile bir ödeme hesabı (fatura ayarları olarak da bilinir) arasındaki hesap düzeyinde bir bağlantıdır. Bu bağlantı, faturalandırma ayarlarının hesap bütçeleri tarafından karşılanan maliyetler 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ı, nihai olarak ödemelerden sorumlu olan bir ödeme profili ile ilişkilidir.

Faturalandırma ayarları, kullanılan ödeme hesabını tanımlayan bir payments_account alanı ve bir grup payments_account_info alanı içerir. Bu alanlar şunlardır:

• payments_account_info.payments_account_id: Faturalandırma ayarlarıyla ilişkili ödeme hesabını tanımlamak için kullanılan, tireli dize olarak biçimlendirilmiş 16 haneli bir kimlik (örneğin, "1234-5678-9012-3456").
• payments_account_info.payments_account_name: Faturalandırma ayarıyla ilişkili ödeme hesabının adı. Bu ad, aylık faturalara yazdırılır.
• payments_account_info.payments_profile_id: Faturalandırma ayarlarıyla ilişkili ödeme profilini tanımlamak için kullanılan, kısa çizgiyle ayrılmış bir dize olarak biçimlendirilmiş 12 haneli kimlik (örneğin, "1234-5678-9012").

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 hesaplara 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 adına (örneğin, customers/{customer_id}/paymentsAccounts/{payments_account_id}) ayarlayın. Ancak payments_account_info değerini değiştirmeyin.

Kullanılabilir ödeme hesabı listesini PaymentsAccountService.ListPaymentsAccounts yöntemiyle oluşturabilirsiniz. Döndürülen PaymentsAccount nesneleri, kimlik doğrulama için kullandığınız yönetici hesabına bağlıdır.

Her PaymentsAccount için ödeme yöneticisinin kaynak adı 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 içinde aşağıdaki alanları ayarlayın (payments_account alanını ayarlamayın):

• payments_account_name
• payments_profile_id

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şlem My New Payments Account adlı yeni bir ödeme hesabı da oluşturur.

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

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, geçerlilik kazanmadan önce onaylanmalıdır. Bu süre zarfında status PENDING durumunda kalır.

Bir BillingSetup aşağıdaki status değerlerden birine sahip olabilir:

Bir 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 (GAQL) sorgusu kullanılarak GoogleAdsService.Search veya GoogleAdsService.SearchStream sorgulanarak getirilir:

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

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

Beklemedeki bir faturalandırma ayarını iptal etme

Henüz geçerli olmayan bir BillingSetup, BillingSetupOperation gönderilerek iptal edilebilir. Bu işlem için remove alanı, faturalandırma ayarlarının kaynak adı (customers/{customer_id}/billingSetups/{billing_setup_id}) olarak ayarlanmalıdır. Faturalandırma ayarları yalnızca status PENDING ise veya gelecekte bir tarihte APPROVED ise iptal edilebilir.