Configuração de faturamento

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 é cobrado pelos custos incorridos pelos orçamentos da conta da configuração de faturamento. Cada conta do 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 é responsável pelas cobranças.

As configurações de faturamento contêm um campo payments_account e um grupo de campos payments_account_info que identificam que a conta do Payments está em uso, incluindo o seguinte:

Se uma conta do Payments for qualificada para faturamento consolidado, várias contas do Google Ads poderão ser agrupadas na mesma fatura, definindo as configurações de faturamento para usar a mesma conta do Payments.

Como 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 do Payments existente, defina payments_account como o ID de recurso de uma conta válida do Payments. No entanto, não modifique payments_account_info.

É possível listar as contas de pagamento disponíveis com o método PaymentsAccountService.ListPaymentsAccounts. O PaymentsAccounts retornado depende 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 do Google Payments

Para vincular uma nova conta do Payments, defina os seguintes campos em payments_account_info. Não defina payments_account:

O exemplo abaixo mostra como criar uma nova configuração de faturamento com um ID de perfil para pagamentos. Como indicado acima, isso também vai criar uma nova conta de pagamentos 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, o cliente vai ser registrado para faturamento usando o perfil de pagamentos referenciado.

Status da configuração de faturamento

As novas instâncias de BillingSetup estão sujeitas a aprovação antes de entrar em vigor. Até lá, o status está no 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 Aprovada, mas o primeiro orçamento correspondente não foi. Isso só pode ocorrer em configurações de faturamento configuradas para faturamento mensal.
APPROVED A configuração foi aprovada.
CANCELLED A configuração foi cancelada pelo usuário antes da aprovação.

Como 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-a para criar um AccountBudgetProposal, conforme descrito em Orçamento da conta.

Como 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 os status estiverem PENDING ou se forem APPROVED para começar no futuro.

Anterior
Visão geral
Próxima
Orçamento da conta