Une configuration de facturation est un lien au niveau du compte entre un compte Google Ads et un compte de paiement (également appelé configuration de facture), qui détermine à qui sont facturés les coûts encourus par les budgets du compte de la configuration de facturation. Chaque compte Payments correspond à une seule facture.
À propos des comptes de paiement
Chaque BillingSetup identifie un compte Payments qui est facturé pour les coûts encourus par les budgets de son compte. Ce compte Payments est associé à un profil de paiement qui est en définitive 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 Payments utilisé, y compris les éléments suivants:
payments_account_info.payments_account_id: identifiant à 16 chiffres permettant d'identifier le compte Payments associé à la configuration de facturation.payments_account_info.payments_account_name: nom du compte Payments associé à la configuration de facturation. Ce nom est imprimé sur les factures mensuelles.payments_account_info.payments_profile_id: ID à 12 chiffres permettant d'identifier le profil de paiement associé à la configuration de la facturation.
Si un compte Payments est éligible à la facturation consolidée, vous pouvez regrouper plusieurs comptes Google Ads sur la même facture en configurant leur facturation pour qu'elle utilise le même compte Payments sous-jacent.
Créer des configurations de facturation
Vous pouvez associer de nouvelles configurations de facturation à des comptes Payments existants ou créés en même temps.
Utiliser un compte de paiement existant
Pour associer un compte Payments existant, définissez payments_account sur l'ID de ressource d'un compte Payments valide. Toutefois, ne modifiez pas payments_account_info.
Vous pouvez lister les comptes de paiement disponibles à l'aide de la méthode PaymentsAccountService.ListPaymentsAccounts. Les PaymentsAccounts renvoyés dépendent du compte administrateur que vous utilisez pour l'authentification.
Pour chaque PaymentsAccount, l'ID de son gestionnaire payant se trouve dans le champ paying_manager_customer.
Utiliser un nouveau compte Payments
Pour associer un nouveau compte Payments, 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 Payments nommé My New Payments Account est é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 de prendre effet. En attendant, leur status est à l'état PENDING.
Un BillingSetup peut être associé à l'un des status suivants:
| État de la configuration de la facturation | Description |
|---|---|
PENDING |
En attente d'approbation |
APPROVED_HELD |
approuvé, mais le premier budget correspondant ne l'a pas été. 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, une BillingSetup est récupérée en interrogeant 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 leur status est PENDING ou si elles doivent commencer à un moment donné.APPROVED