Fatura ayarları, Google Ads hesabı ile ödeme hesabı (fatura ayarları olarak da bilinir) arasında hesap düzeyinde bir bağlantıdır. Bu bağlantı, fatura ayarlarının hesap bütçeleri nedeniyle oluşan maliyetler için kime fatura kesileceğini belirler. Her ödeme hesabı tek bir faturaya karşılık gelir.
Ödeme hesapları hakkında
Her BillingSetup, hesap bütçeleri tarafından tahakkuk eden maliyetler için faturalandırılan bir ödeme hesabını tanımlar. Bu ödeme hesabı, ücretlerden sorumlu olan bir ödeme profili ile ilişkilidir.
Faturalandırma ayarları, hem bir payments_account alanı hem de kullanımda olan ödeme hesabını tanımlayan bir grup payments_account_info alanı içerir. Bu alanlar arasında şunlar bulunur:
payments_account_info.payments_account_id: Faturalandırma ayarlarıyla ilişkili ödeme hesabını tanımlamak için kullanılan, kısa çizgiyle ayrılmış bir dize biçiminde 16 haneli bir kimlik (ör."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 faturalarda gösterilir.payments_account_info.payments_profile_id: Faturalandırma kurulumuyla ilişkili ödeme profilini tanımlamak için kullanılan, kısa çizgiyle ayrılmış bir dize (ör."1234-5678-9012") olarak biçimlendirilmiş 12 haneli bir kimlik.
Bir ödeme hesabı birleştirilmiş faturalandırma için uygunsa birden fazla Google Ads hesabı, faturalandırma ayarları aynı ödeme hesabını kullanacak şekilde ayarlanarak 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ına bağlamak için payments_account değerini geçerli bir ödeme hesabının kaynak adı (ör. customers/{customer_id}/paymentsAccounts/{payments_account_id}) olarak ayarlayın. Ancak payments_account_info değerini değiştirmeyin.
Kullanılabilir ödeme hesaplarını PaymentsAccountService.ListPaymentsAccounts yöntemiyle listeleyebilirsiniz.
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ına bağlamak için payments_account_info içinde aşağıdaki alanları ayarlayın (payments_account alanını ayarlamayın):
Aşağıdaki örnekte, mevcut bir ödeme profili kimliğinden yeni bir faturalandırma ayarının nasıl oluşturulacağı gösterilmektedir. Daha önce belirtildiği gibi, bu işlem aynı zamanda My New Payments Account adında yeni bir ödeme hesabı 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 müşterinin faturalandırma kaydı, referans verilen ödeme profili kullanılarak yapılır.
Faturalandırma ayarlarının durumu
Yeni BillingSetup örnekleri, geçerlilik kazanmadan önce onaya tabidir. Bu süre zarfında status PENDING durumunda olur.
Bir BillingSetup, aşağıdaki status değerlerinden birine sahip olabilir:
BillingSetupStatus |
Açıklama |
|---|---|
PENDING |
Onay bekleniyor. |
APPROVED_HELD |
Onaylandı ancak ilgili ilk bütçe onaylanmadı. 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. |
Bir hesabın faturalandırma ayarlarını alma
Google Ads API'deki diğer çoğu varlık gibi BillingSetup, hangi alanların döndürüleceğini 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 bu referansı kullanabilirsiniz.
Beklemedeki bir faturalandırma kurulumunu iptal etme
Henüz geçerlilik kazanmamış bir BillingSetup, remove alanı faturalandırma ayarının kaynak adına (customers/{customer_id}/billingSetups/{billing_setup_id}) ayarlanmış bir BillingSetupOperation gönderilerek iptal edilebilir. Faturalandırma ayarları yalnızca status değerleri PENDING ise veya gelecekte bir zamanda başlayacak şekilde APPROVED iptal edilebilir.