Configurações 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 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 a conta para pagamentos em uso, incluindo:

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.

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 que já existe

Para vincular a uma conta para pagamentos existente, defina payments_account como o nome do recurso de uma conta para pagamentos válida (por exemplo, customers/{customer_id}/paymentsAccounts/{payments_account_id}). No entanto, não modifique payments_account_info.

É possível listar as contas para pagamentos disponíveis com o método PaymentsAccountService.ListPaymentsAccounts. Os objetos PaymentsAccount retornados dependem da conta de administrador usada para autenticação.

Para cada PaymentsAccount, o nome do recurso do administrador pagador está no campo paying_manager_customer.

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 configuração de faturamento usando um ID do perfil para pagamentos. Como indicado anteriormente, isso também cria uma nova conta para pagamentos com o nome My New Payments Account.

BillingSetup billingSetup =
    BillingSetup.newBuilder()
        .setPaymentsAccountInfo(
            PaymentsAccountInfo.newBuilder()
                .setPaymentsAccountName("My New Payments Account")
                .setPaymentsProfileId("1234-5678-9012")
                .build())
        .setStartTimeType(TimeTypeEnum.TimeType.NOW)
        .build();

BillingSetupOperation operation =
    BillingSetupOperation.newBuilder().setCreate(billingSetup).build();

try (BillingSetupServiceClient billingSetupServiceClient =
    googleAdsClient.getBillingSetupServiceClient()) {
  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(
          Long.toString(customerId), operation);
}

Se essa for a primeira configuração de faturamento adicionada a uma conta do Google Ads, o cliente será inscrito para faturamento usando o perfil para pagamentos mencionado.

Status da configuração de faturamento

As novas instâncias de BillingSetup estão sujeitas à aprovação antes de entrarem em vigor. Até lá, o status vai estar em um estado PENDING.

Um BillingSetup pode ter um dos seguintes valores de status:

BillingSetupStatus Descrição
PENDING Aprovação pendente.
APPROVED_HELD Aprovado, mas o primeiro orçamento correspondente não foi aprovado. Isso só pode ocorrer em configurações de 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 GoogleAdsService.Search ou GoogleAdsService.SearchStream usando uma consulta da Linguagem de consulta do Google Ads (GAQL) que especifica quais campos retornar:

SELECT
  billing_setup.resource_name,
  billing_setup.id,
  billing_setup.status,
  billing_setup.payments_account,
  billing_setup.payments_account_info.payments_account_id,
  billing_setup.payments_account_info.payments_account_name,
  billing_setup.payments_account_info.payments_profile_id,
  billing_setup.payments_account_info.payments_profile_name,
  billing_setup.start_date_time,
  billing_setup.end_date_time,
  billing_setup.end_time_type
FROM billing_setup

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

Cancelar uma configuração de faturamento pendente

Uma BillingSetup que ainda não entrou em vigor pode ser cancelada enviando uma BillingSetupOperation com o campo remove definido como o nome do recurso da configuração de faturamento (customers/{customer_id}/billingSetups/{billing_setup_id}). As configurações de faturamento só podem ser canceladas se o status for PENDING ou se estiverem APPROVED para começar em algum momento no futuro.

Anterior
Visão geral do faturamento
Avançar
Orçamento da conta