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 addebitati i costi sostenuti dai budget dell'account della configurazione di fatturazione. Ogni account pagamenti corrisponde a una singola fattura.
Informazioni sugli account pagamenti
Ogni elemento 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 è infine responsabile degli addebiti.
Le configurazioni di fatturazione contengono un campo payments_account
e 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 è riportato sulle fatture mensili.payments_account_info.payments_profile_id
: un ID di 12 cifre utilizzato per identificare il profilo pagamenti associato alla configurazione di fatturazione.
Se un account pagamenti è idoneo alla fatturazione consolidata, più account Google Ads possono essere raggruppati nella stessa fattura impostando le relative configurazioni di fatturazione in modo che utilizzino lo stesso account pagamenti sottostante.
Creazione di nuove configurazioni di fatturazione
Puoi collegare nuove configurazioni di fatturazione ad account pagamenti esistenti o a quelli creati contemporaneamente.
Utilizzo di 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 dell'amministratore pagamenti si trova nel campo paying_manager_customer
.
Utilizzo di un nuovo account pagamenti
Per eseguire il collegamento a 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 sopra, verrà 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 che viene aggiunta a un account Google Ads, il cliente registrerà effettivamente la fatturazione utilizzando il profilo pagamenti di riferimento.
Stato della configurazione di fatturazione
Le nuove istanze BillingSetup
sono soggette ad
approvazione prima di diventare effettive. Fino ad allora, status
si trova in uno stato PENDING
.
Un elemento BillingSetup
può trovarsi in uno dei seguenti stati:
status
:
Stato configurazione fatturazione | Descrizione |
---|---|
PENDING |
In attesa di approvazione. |
APPROVED_HELD |
Approvato, ma il primo budget corrispondente non è stato approvato. Questo 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. |
Recupero della configurazione di fatturazione di un account
Come la maggior parte delle altre entità nell'API Google Ads, un elemento BillingSetup
viene recuperato eseguendo una query su GoogleAdsService.SearchStream
utilizzando una query Linguaggio di query Google Ads che specifica i campi da restituire.
Dopo aver ottenuto un riferimento a una BillingSetup
,
puoi utilizzarlo per creare una
AccountBudgetProposal
come descritto in
Budget dell'account.
Annullamento di una configurazione di fatturazione in attesa
Un elemento BillingSetup
non ancora applicato può
essere annullato utilizzando l'operazione di rimozione. Le configurazioni di fatturazione possono essere annullate solo se
le status
sono
PENDING
o se devono APPROVED
iniziare in un momento futuro.