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