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 efetivamente determina quem será 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 recebe uma fatura 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 payments_account campo e um grupo de payments_account_info campos que identificam a conta para pagamentos em uso, incluindo o seguinte:

Se uma conta para pagamentos for qualificada para o faturamento consolidado, então 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 criadas ao mesmo tempo.

Usar uma conta para pagamentos atual

Para vincular a uma conta para pagamentos atual, 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 as contas para pagamentos disponíveis com o PaymentsAccountService.ListPaymentsAccounts método. As PaymentsAccounts retornadas dependem da conta de administrador usada para autenticação.

Para cada PaymentsAccount, o ID do seu administrador pagador está no paying_manager_customer campo.

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 nova configuração de faturamento com um ID do perfil para pagamentos atual. Como indicado anteriormente, isso também cria 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, o cliente será inscrito no faturamento usando o perfil para pagamentos referenciado.

Status da configuração de faturamento

Novas BillingSetup instâncias estão sujeitas à aprovação antes de entrarem em vigor. Até então, o status delas está em um PENDING estado.

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 ocorrer para 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.

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, você pode usá-la para criar uma 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 delas for PENDING ou se forem APPROVED para começar em algum momento no futuro.

Anterior
Vista geral da faturação
Avançar
Orçamento da conta