Une configuration de facturation est une association au niveau du compte entre un compte Google Ads et un compte de paiement (également appelé configuration de facture). Elle permet de déterminer à qui les coûts engendrés par les budgets de compte de la configuration de facturation sont facturés. Chaque compte de paiement correspond à une seule facture.
À propos des comptes de paiement
Chaque BillingSetup
identifie un compte de paiement qui est facturé pour les coûts engendrés par ses budgets de compte. Ce compte de paiement est associé à un profil de paiement, qui est responsable des frais.
Les configurations de facturation contiennent à la fois un champ payments_account
et un groupe de champs payments_account_info
qui identifient le compte de paiement utilisé, y compris les suivants:
payments_account_info.payments_account_id
: identifiant à 16 chiffres permettant d'identifier le compte de paiement associé à la configuration de la facturation.payments_account_info.payments_account_name
: nom du compte de paiement associé à la configuration de la facturation. Ce nom est imprimé sur les factures mensuelles.payments_account_info.payments_profile_id
: identifiant à 12 chiffres permettant d'identifier le profil de paiement associé à la configuration de la facturation.
Si un compte de paiement est éligible à la facturation consolidée, vous pouvez regrouper plusieurs comptes Google Ads sur la même facture en définissant leurs configurations de facturation de sorte qu'elles utilisent le même compte de paiement sous-jacent.
Créer des configurations de facturation
Vous pouvez associer de nouvelles configurations de facturation à des comptes de paiement existants ou à des comptes créés en même temps.
Utiliser un compte de paiement existant
Pour associer un compte de paiement existant, définissez payments_account
sur l'ID de ressource d'un compte de paiement valide. Toutefois, ne modifiez pas payments_account_info
.
Vous pouvez répertorier les comptes de paiement disponibles avec la méthode PaymentsAccountService.ListPaymentsAccounts
. Le PaymentsAccounts
renvoyé dépend du compte administrateur que vous utilisez pour l'authentification.
Pour chaque PaymentsAccount
, l'ID de son administrateur des paiements se trouve dans le champ paying_manager_customer
.
Utiliser un nouveau compte de paiement
Pour associer un nouveau compte de paiement, définissez les champs suivants dans payments_account_info
(ne définissez pas payments_account
):
L'exemple ci-dessous montre comment créer une configuration de facturation à partir d'un ID de profil de paiement existant. Comme indiqué ci-dessus, un compte de paiement nommé My New Payments Account
sera également créé.
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);
}
S'il s'agit de la première configuration de facturation ajoutée à un compte Google Ads, le client sera effectivement inscrit à la facturation à l'aide du profil de paiement référencé.
État de la configuration de la facturation
Les nouvelles instances BillingSetup
doivent être approuvées avant d'entrer en vigueur. En attendant, l'état de status
est PENDING
.
Un BillingSetup
peut se trouver dans l'un des status
suivants:
État de la configuration de la facturation | Description |
---|---|
PENDING |
En attente d'approbation |
APPROVED_HELD |
Approuvé, mais pas le premier budget correspondant. Cela ne peut se produire que pour les configurations de facturation configurées pour la facturation mensuelle. |
APPROVED |
La configuration a été approuvée. |
CANCELLED |
La configuration a été annulée par l'utilisateur avant l'approbation. |
Récupérer la configuration de facturation d'un compte
Comme la plupart des autres entités de l'API Google Ads, un BillingSetup
est extrait en interrogeant l'GoogleAdsService.SearchStream
à l'aide d'une requête en langage de requête Google Ads qui spécifie les champs à renvoyer.
Une fois que vous avez obtenu une référence à un BillingSetup
, vous pouvez l'utiliser pour créer un AccountBudgetProposal
, comme décrit dans la section Budget du compte.
Annuler une configuration de facturation en attente
Un BillingSetup
qui n'a pas encore pris effet peut être annulé à l'aide de l'opération de suppression. Les configurations de facturation ne peuvent être annulées que si leurs status
sont PENDING
ou si elles sont APPROVED
pour commencer à une date ultérieure.