Fatura 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ı, fatura ayarı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çeleriyle oluşan maliyetler için faturalandırılan bir ödeme hesabını tanımlar. Bu ödeme hesabı, nihayetinde ücretlerden sorumlu olan bir ödeme profili ile ilişkilendirilmiştir.
Faturalandırma ayarları hem bir
payments_account
alanı hem de
kullanımdaki ödeme hesabını tanımlayan bir grup
payments_account_info
alanı içerir. Bu alanlardan bazıları şunlardır:
payments_account_info.payments_account_id
: Faturalandırma ayarlarıyla ilişkili ödeme hesabını tanımlamak için kullanılan 16 haneli kimlik.payments_account_info.payments_account_name
: Faturalandırma ayarları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 12 haneli kimlik.
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ği olarak 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 ödeme 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
içinde 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şlem My New Payments Account
adlı yeni bir ödeme hesabı da oluşturur.
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 müşteri, referans verilen ödeme profilini kullanarak faturalandırmaya kaydolmuş olur.
Faturalandırma kurulumu durumu
Yeni BillingSetup
örnekleri, geçerli hale gelmeden önce onaylanmalıdır. Bu tarihe kadar status
, PENDING
durumunda kalır.
BillingSetup
, aşağıdaki status
durumlarından birinde olabilir:
Faturalandırma Ayarı Durumu | 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 bir 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
PENDING
veya gelecekteki bir tarihte APPROVED
ise iptal edilebilir.