Configuração de faturamento

Uma configuração de faturamento é um vínculo no nível da conta entre uma conta do Google Ads e uma para pagamentos (também conhecida como configuração de fatura), que determina efetivamente quem é faturado pelos custos incorridos pelos orçamentos da conta para essa configuração. Cada conta para pagamentos corresponde a uma única fatura.

Sobre as contas para pagamentos

Cada BillingSetup identifica uma conta para pagamentos que é faturada com os custos incorridos pelos orçamentos da conta. Essa conta 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 a conta para pagamentos em uso, incluindo o seguinte:

Se uma conta para pagamentos estiver qualificada para o 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 para pagamentos subjacente.

Criar novas configurações de faturamento

É possível vincular novas configurações de faturamento a contas para pagamentos atuais ou aquelas criadas ao mesmo tempo.

Com uma conta para pagamentos atual

Para vincular a uma conta para pagamentos existente, defina payments_account como o ID de recurso de uma conta para pagamentos válida. No entanto, não modifique payments_account_info.

Liste as contas para pagamentos 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 administrador pagador está no campo paying_manager_customer.

Como usar uma nova conta para pagamentos

Para vincular uma nova conta para pagamentos, 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 base em um ID do perfil para pagamentos existente. Conforme indicado acima, isso também criará uma nova conta para 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 se inscrever para faturamento usando o perfil para pagamentos referenciado.

Status da configuração de faturamento

Novas instâncias de BillingSetup estão sujeitas a aprovação antes de entrarem em vigor. Até lá, o status fica no estado PENDING.

Um BillingSetup pode estar em uma das 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. Isso só pode ocorrer em configurações de faturamento definidas 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, a busca de um BillingSetup é feita consultando o GoogleAdsService.SearchStream usando uma consulta da linguagem de consulta do Google Ads que especifica quais campos retornar.

Depois de conseguir uma referência a um BillingSetup, você pode usá-la para criar um AccountBudgetProposal, conforme descrito em Orçamento da conta.

Como cancelar uma configuração de faturamento pendente

Uma BillingSetup que ainda não entrou em vigor pode ser cancelada usando a operação de remoção. As configurações de faturamento só poderão ser canceladas se as status delas forem PENDING ou se forem APPROVED para iniciar no futuro.