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 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 para pagamentos corresponde a uma única fatura.

Sobre as contas para pagamentos

Cada BillingSetup identifica uma conta para pagamentos que é faturada pelos custos incorridos pelos orçamentos da conta. Essa conta está associada a um perfil para pagamentos que é o 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 for qualificada para faturamento consolidado, várias contas do Google Ads poderão ser agrupadas na mesma fatura. Basta definir 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 às criadas ao mesmo tempo.

Como usar uma conta para pagamentos existente

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

É possível listar 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 a 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 a partir de um ID do perfil para pagamentos atual. 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 essa for a primeira configuração de faturamento adicionada a uma conta do Google Ads, ela inscreverá o cliente para o faturamento usando o perfil para pagamentos indicado.

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 um destes 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 ocorrer com 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, um BillingSetup é buscado consultando o GoogleAdsService.SearchStream com uma consulta na linguagem de consulta do Google Ads que especifica quais campos serão retornados.

Depois de conseguir uma referência a um BillingSetup, você pode usá-lo 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ó poderão ser canceladas se o status for PENDING ou se for APPROVED para iniciar em algum momento no futuro.

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