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 do Payments (também conhecida como fatura configuração), o que ajuda determina quem é cobrado pelos custos incorridos pela conta da configuração de faturamento orçamentos. 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. Este pagamento está associada a uma conta de pagamento perfil que é essencial responsável pelas cobranças.

As configurações de faturamento contêm um payments_account. e um grupo de payments_account_info campos que identificam a conta para pagamentos em uso, incluindo o seguinte:

Se uma conta para pagamentos estiver qualificada para o modo consolidado faturamento, várias solicitações do Google As contas do Google Ads podem 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

Você pode vincular novas configurações de faturamento a contas para pagamentos existentes ou às criadas ao mesmo tempo.

Como usar uma conta para pagamentos existente

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

Você pode listar as contas para pagamentos disponíveis com o PaymentsAccountService.ListPaymentsAccounts método. A PaymentsAccounts retornados dependem da conta de administrador usada para autenticação.

Para cada PaymentsAccount, o ID do grupo pagante administrador está na lista 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 uma ID do perfil para pagamentos. Como indicado acima, isso também vai criar 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 a guia "Pagamentos" mencionada perfil.

Status da configuração de faturamento

Novas instâncias do BillingSetup estão sujeitas a aprovação antes que entrem em vigor. Até lá, status está em um PENDING estado.

Um BillingSetup pode estar em um dos seguintes formatos: 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 do Google Ads, uma BillingSetup é buscado consultando o GoogleAdsService.SearchStream usando uma consulta na Linguagem de consulta do Google Ads que especifica quais campos serão mostrados.

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

Como cancelar uma configuração de faturamento pendente

Uma BillingSetup que ainda não entrou em vigor pode pode ser cancelado usando a operação de remoção. As configurações de faturamento só podem ser canceladas os status deles estão PENDING ou se ela for APPROVED para começar em algum momento no futuro.