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 chi riceve la fattura per 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 è l'unico 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 formattato come stringa con trattini (ad esempio,"1234-5678-9012-3456") 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 formattato come stringa con trattini (ad esempio,"1234-5678-9012") utilizzato per identificare il profilo pagamenti associato alla configurazione di fatturazione.
Se un account pagamenti è idoneo per la 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.
Crea nuove configurazioni di fatturazione
Puoi collegare nuove configurazioni di fatturazione ad account pagamenti esistenti o creati contemporaneamente.
Utilizza un account pagamenti esistente
Per eseguire il collegamento a un account pagamenti esistente, imposta payments_account sul nome della risorsa di un account pagamenti valido (ad esempio customers/{customer_id}/paymentsAccounts/{payments_account_id}). Tuttavia, non modificare payments_account_info.
Puoi elencare gli account pagamenti disponibili con il metodo PaymentsAccountService.ListPaymentsAccounts.
Gli oggetti PaymentsAccount restituiti dipendono dall'account amministratore che utilizzi per l'autenticazione.
Per ogni PaymentsAccount, il nome della risorsa del suo amministratore pagamenti si trova nel campo paying_manager_customer.
Utilizza 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 in precedenza, viene creato anche un nuovo account pagamenti con il nome My New Payments Account.
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);
}
Se questa è la prima configurazione di fatturazione aggiunta a un account Google Ads, il cliente verrà registrato alla 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, il loro status è
in uno stato PENDING.
Un BillingSetup può avere uno dei seguenti valori status:
BillingSetupStatus |
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. |
Recupera 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.Search o GoogleAdsService.SearchStream utilizzando una query Google Ads Query Language (GAQL) che specifica i campi da restituire:
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
Una volta ottenuto un riferimento a un BillingSetup,
puoi utilizzarlo per creare un AccountBudgetProposal
come descritto in Budget dell'account.
Annulla una configurazione di fatturazione in attesa
Una BillingSetup che non è ancora entrata in vigore può essere annullata
inviando una BillingSetupOperation con il campo
remove impostato sul nome della risorsa della configurazione di fatturazione (customers/{customer_id}/billingSetups/{billing_setup_id}). Le configurazioni di fatturazione
possono essere annullate solo se il loro status è
PENDING o se sono APPROVED per
iniziare in un momento futuro.