Configurazione della fatturazione

Una configurazione di fatturazione è un collegamento a livello di account tra un account Google Ads e un account pagamenti (noto anche come configurazione di fatturazione), 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 BillingSetup identifica un account pagamenti a cui vengono fatturati i costi sostenuti in base ai budget dell'account. Questo account pagamenti è associato a un profilo pagamenti che è in definitiva responsabile 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 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 le nuove configurazioni di fatturazione agli 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 utilizzando il metodo PaymentsAccountService.ListPaymentsAccounts. Il valore PaymentsAccounts restituito dipende dall'account amministratore utilizzato per l'autenticazione.

Per ogni PaymentsAccount, l'ID del relativo 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):

• payments_account_name
• payments_profile_id

Nota: entrambi i valori payments_account e payments_account_info verranno compilati nei successivi recuperi della configurazione di fatturazione.

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 aggiunta a un account Google Ads, il cliente verrà effettivamente registrato per la fatturazione utilizzando il profilo pagamenti di riferimento.

Stato configurazione fatturazione

Le nuove istanze BillingSetup sono soggette ad approvazione prima di diventare effettive. Fino ad allora, l'status sarà in stato PENDING.

Un BillingSetup può essere in uno dei seguenti status:

Stato della configurazione di fatturazione	Descrizione
PENDING	In attesa di approvazione.
APPROVED_HELD	È stata approvata, ma il primo budget corrispondente non l'ha fatto. Questo può avvenire 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, una BillingSetup viene recuperata eseguendo una query su GoogleAdsService.SearchStream utilizzando una query Linguaggio di query di Google Ads in cui sono specificati i campi da restituire.

Una volta ottenuto un riferimento a BillingSetup, puoi utilizzarlo per creare un AccountBudgetProposal come descritto in Budget dell'account.

Annullare una configurazione di fatturazione in attesa

Un elemento BillingSetup che non è ancora stato applicato può essere annullato utilizzando l'operazione di rimozione. Le configurazioni di fatturazione possono essere annullate solo se i relativi status sono PENDING o se APPROVED lavoreranno in futuro.