Configuration de la facturation

Une configuration de facturation est une association au niveau d'un compte entre un compte Google Ads et un compte de paiement (également appelé facture de votre application), ce qui permet détermine qui est facturé pour les coûts engendrés par le compte associé à la configuration de facturation les budgets. Chaque compte de paiement correspond à une seule facture.

À propos des comptes de paiement

Chaque BillingSetup identifie un compte de paiement qui se voit facturer les coûts engendrés par ses budgets de compte. Ce paiement est associé à un compte Payments profil, qui est finalement est responsable des frais.

Les configurations de facturation contiennent à la fois un payments_account et un groupe de payments_account_info qui identifient le compte de paiement utilisé, y compris:

Si un compte de paiement peut bénéficier des critères consolidés facturation, puis plusieurs comptes Google Vous pouvez regrouper des comptes Ads sur une même facture en définissant leur configuration de facturation pour utiliser 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 votre compte de paiement à un compte de paiement existant, définissez payments_account jusqu'à 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 à l'aide du PaymentsAccountService.ListPaymentsAccounts . La La valeur PaymentsAccounts renvoyée dépend du compte administrateur utilisé l'authentification unique.

Pour chaque PaymentsAccount, l'identifiant de la classe payée de sécurité se trouve dans le 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'une ID du profil de paiement. Comme indiqué ci-dessus, cette opération va également créer Compte de paiement nommé 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);
}

S'il s'agit de la première configuration de facturation ajoutée à un compte Google Ads, l'inscription du client à la facturation en utilisant le modèle de paiement profil.

État de la configuration de la facturation

Les nouvelles instances BillingSetup sont soumises aux avant leur entrée en vigueur. D'ici là, leurs status se trouve dans un PENDING de l'état.

Un BillingSetup peut se trouver dans l'un des éléments suivants status:

É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, BillingSetup est récupérée en interrogeant la GoogleAdsService.SearchStream à l'aide d'une requête Google Ads en langage de requête qui spécifie les champs à renvoyer.

Une fois que vous avez obtenu une référence à un élément BillingSetup, vous pouvez l'utiliser pour créer AccountBudgetProposal comme décrit dans Budget du compte :

Annuler une configuration de facturation en attente

Un BillingSetup qui n'est pas encore pris en compte peut être annulés à l'aide de l'opération "remove". Les configurations de facturation ne peuvent être annulées que leurs status sont PENDING ou s'il s'agit de APPROVED à un moment ultérieur.