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:
payments_account_info.payments_account_id
: um ID de 16 dígitos usado para identificar a conta para pagamentos associada à configuração de faturamento.payments_account_info.payments_account_name
: o nome da conta para pagamentos associada à configuração de faturamento. Esse nome é impresso nas faturas mensais.payments_account_info.payments_profile_id
: um ID de 12 dígitos usado para identificar o perfil para pagamentos associado à configuração de faturamento.
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.