Una configurazione di fatturazione è un collegamento a livello di account tra un account Google Ads e un account pagamenti (chiamato anche 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 per cui vengono fatturati i costi sostenuti dai budget dell'account. Questo account pagamenti è associato a un profilo pagamenti che è responsabile degli addebiti.
Le configurazioni di fatturazione contengono sia un campo payments_account sia un gruppo di payments_account_info campi 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 della 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, è possibile raggruppare più account Google Ads nella stessa fattura impostando le relative configurazioni di fatturazione in modo che utilizzino lo stesso account pagamenti sottostante.
Creare nuove configurazioni di fatturazione
Puoi collegare le nuove configurazioni di fatturazione agli account pagamenti esistenti o a quelli creati contemporaneamente.
Utilizza un account pagamenti esistente
Per eseguire il collegamento 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. Il valore PaymentsAccounts restituito dipende dall'account amministratore utilizzato per l'autenticazione.
Per ogni PaymentsAccount, l'ID del relativo amministratore pagato è nel campo paying_manager_customer.
Utilizzare un nuovo account pagamenti
Per eseguire il collegamento con un nuovo account pagamenti, imposta i seguenti campi in payments_account_info (non impostare payments_account):
L'esempio seguente mostra come creare una nuova configurazione di fatturazione da un ID profilo pagamenti esistente. Come indicato in precedenza, viene creato anche un nuovo account Payments 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 si tratta della prima configurazione di fatturazione aggiunta a un account Google Ads, il cliente verrà effettivamente registrato alla fatturazione utilizzando il profilo pagamenti a cui si fa riferimento.
Stato della configurazione di fatturazione
Le nuove istanze BillingSetup sono soggette all'approvazione prima di entrare in vigore. Fino ad allora, il suo status è in stato PENDING.
Un BillingSetup può trovarsi in uno dei seguenti modi: status
| Stato della configurazione della fatturazione | Descrizione |
|---|---|
PENDING | In attesa di approvazione. |
APPROVED_HELD | È stato approvato, ma non il primo budget corrispondente. Questo può accadere 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 su GoogleAdsService.SearchStream utilizzando una query in 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 le relative status sono PENDING o se devono APPROVED iniziare in un secondo momento.