Uma configuração de faturamento é um link no nível da conta entre uma conta do Google Ads e uma conta para pagamentos (também conhecida como configuração de fatura), que determina quem recebe a cobrança pelos custos incorridos pelos orçamentos da conta da configuração de faturamento. Cada conta do Google Payments corresponde a uma única fatura.
Sobre as contas para pagamentos
Cada BillingSetup identifica uma conta para pagamentos
que recebe faturas pelos custos incorridos pelos orçamentos da conta. Essa conta para pagamentos está associada a um perfil para pagamentos que é o responsável final pelas cobranças.
As configurações de faturamento contêm um campo payments_account e um grupo de campos payments_account_info que identificam a conta para pagamentos em uso, incluindo:
payments_account_info.payments_account_id: um ID de 16 dígitos usado para identificar a conta do Google Payments associada à configuração de faturamento.payments_account_info.payments_account_name: O nome da conta do Google Payments associada à configuração de faturamento. Esse nome é impresso nas faturas mensais.payments_account_info.payments_profile_id: um ID de 12 dígitos usado para identificar o perfil para pagamentos associado à configuração de faturamento.
Se uma conta para pagamentos se qualificar para o faturamento consolidado, várias contas do Google Ads poderão ser agrupadas na mesma fatura ao definir as configurações de faturamento para usar a mesma conta para pagamentos.
Criar novas configurações de faturamento
É possível vincular novas configurações de faturamento a contas para pagamentos atuais ou criadas ao mesmo tempo.
Usar uma conta para pagamentos existente
Para vincular a uma conta para pagamentos existente, defina payments_account como o ID do recurso de uma conta válida. No entanto, não modifique
payments_account_info.
É possível listar as contas para pagamentos disponíveis com o
método
PaymentsAccountService.ListPaymentsAccounts. Os
PaymentsAccounts retornados dependem da conta de administrador usada para
autenticação.
Para cada PaymentsAccount, o ID do gerente pagador está no campo paying_manager_customer.
Usar uma nova conta para pagamentos
Para vincular a uma nova conta para pagamentos, defina os seguintes campos em
payments_account_info
(não defina payments_account):
O exemplo a seguir mostra como criar uma configuração de faturamento usando um ID de perfil para pagamentos. Como indicado anteriormente, isso também cria uma nova conta do Payments com o 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 esta for a primeira configuração de faturamento adicionada a uma conta do Google Ads, isso vai inscrever o cliente no faturamento usando o perfil para pagamentos referenciado.
Status da configuração de faturamento
As novas instâncias BillingSetup precisam de aprovação antes de serem efetivadas. Até lá, o
status fica em um estado
PENDING.
Um BillingSetup pode estar em um dos seguintes
status:
| Status da configuração de faturamento | Descrição |
|---|---|
PENDING |
Aprovação pendente. |
APPROVED_HELD |
Aprovado, mas o primeiro orçamento correspondente não foi. Isso só pode acontecer com configurações de faturamento mensal. |
APPROVED |
A configuração foi aprovada. |
CANCELLED |
A configuração foi cancelada pelo usuário antes da aprovação. |
Recuperar a configuração de faturamento de uma conta
Como a maioria das outras entidades na API Google Ads, um
BillingSetup é buscado consultando o
GoogleAdsService.SearchStream
usando uma consulta da linguagem de consulta do Google Ads que especifica quais campos retornar.
Depois de receber uma referência a um BillingSetup,
use-o para criar um
AccountBudgetProposal, conforme descrito em
Orçamento da conta.
Cancelar uma configuração de faturamento pendente
Um BillingSetup que ainda não entrou em vigor pode
ser cancelado usando a operação de remoção. As configurações de faturamento só podem ser canceladas se o status estiver PENDING ou se estiver APPROVED para começar em algum momento no futuro.