Una configurazione di fatturazione è un collegamento a livello di account tra un account Google Ads e un account pagamenti (noto anche come configurazione fattura), che determina in modo efficace a chi vengono fatturati i costi sostenuti dai budget dell'account della configurazione di fatturazione. Ogni account pagamenti corrisponde a una singola fattura.
Informazioni sugli account pagamenti
Ogni BillingSetup identifica un account pagamenti
a cui vengono fatturati i costi sostenuti dai budget dell'account. Questo account
pagamenti è associato a un profilo
pagamenti che è il
responsabile finale degli addebiti.
Le configurazioni di fatturazione contengono sia un campo
payments_account sia un gruppo di campi
payments_account_info
che identificano l'account pagamenti in uso, tra cui:
payments_account_info.payments_account_id: Un ID di 16 cifre utilizzato per identificare l'account pagamenti associato alla configurazione di fatturazione.payments_account_info.payments_account_name: Il nome dell'account pagamenti associato alla configurazione di fatturazione. Questo nome viene stampato sulle fatture mensili.payments_account_info.payments_profile_id: Un ID di 12 cifre utilizzato per identificare il profilo pagamenti associato alla configurazione della fatturazione.
Se un account pagamenti è idoneo per la fatturazione consolidata, più account Google Ads possono essere raggruppati nella stessa fattura impostando le configurazioni di fatturazione in modo che utilizzino lo stesso account pagamenti sottostante.
Creare nuove configurazioni di fatturazione
Puoi collegare nuove configurazioni di fatturazione a conti pagamenti esistenti o a quelli creati contemporaneamente.
Utilizzare un account pagamenti esistente
Per collegarti a un account pagamenti esistente, imposta
payments_account sull'ID risorsa di un account pagamenti valido. Tuttavia, non modificare
payments_account_info.
Puoi elencare gli account pagamenti disponibili con il
metodo PaymentsAccountService.ListPaymentsAccounts. I
PaymentsAccounts restituiti dipendono dall'account amministratore che utilizzi per
l'autenticazione.
Per ogni PaymentsAccount, l'ID del relativo gestore
pagamenti si trova nel
campo
paying_manager_customer.
Utilizzare un nuovo account pagamenti
Per collegare un nuovo account pagamenti, imposta i seguenti campi in
payments_account_info
(non impostare payments_account):
Il seguente esempio mostra come creare una nuova configurazione di fatturazione da un ID profilo pagamenti esistente. Come indicato in precedenza, viene creato anche un nuovo account
pagamenti con il nome My New Payments Account.
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);
}
Se questa è la prima configurazione di fatturazione aggiunta a un account Google Ads, il cliente verrà registrato per la fatturazione utilizzando il profilo pagamenti di riferimento.
Stato della configurazione di fatturazione
Le nuove istanze di BillingSetup sono soggette
ad approvazione prima di entrare in vigore. Fino ad allora, il loro
status è in uno stato
PENDING.
Un BillingSetup può avere uno dei seguenti
status:
| Stato della configurazione di fatturazione | Descrizione |
|---|---|
PENDING |
In attesa di approvazione. |
APPROVED_HELD |
Approvato, ma il primo budget corrispondente no. Ciò può verificarsi solo per le configurazioni di fatturazione configurate per la fatturazione mensile. |
APPROVED |
La configurazione è stata approvata. |
CANCELLED |
La configurazione è stata annullata dall'utente prima dell'approvazione. |
Recuperare la configurazione di fatturazione di un account
Come la maggior parte delle altre entità nell'API Google Ads, un
BillingSetup viene recuperato eseguendo una query
GoogleAdsService.SearchStream
utilizzando una query del linguaggio di query di Google Ads che specifica i campi da restituire.
Una volta ottenuto un riferimento a un BillingSetup,
puoi utilizzarlo per creare un
AccountBudgetProposal come descritto in
Budget dell'account.
Annullare una configurazione di fatturazione in attesa
Un BillingSetup che non è ancora entrato in vigore può
essere annullato utilizzando l'operazione di rimozione. Le configurazioni di fatturazione possono essere annullate solo se
i relativi status sono
PENDING
o se sono APPROVED
e inizieranno in un momento futuro.