Eine Abrechnungseinrichtung ist eine Verknüpfung auf Kontoebene zwischen einem Google Ads-Konto und einem Zahlungskonto (auch als Rechnungseinrichtung bezeichnet). Auf diese Weise wird festgelegt, wem Kosten für die Kontobudgets der Abrechnungseinrichtung in Rechnung gestellt werden. Jedes Zahlungskonto entspricht einer einzelnen Rechnung.
Zahlungskonten
Jedes BillingSetup
identifiziert ein Zahlungskonto, dem Kosten für dessen Kontobudgets in Rechnung gestellt werden. Dieses Zahlungskonto ist mit einem Zahlungsprofil verknüpft, das letztendlich für die Kosten verantwortlich ist.
Abrechnungseinrichtungen enthalten sowohl das Feld payments_account
als auch eine Gruppe von payments_account_info
-Feldern, die angeben, welches Zahlungskonto verwendet wird. Dazu gehören:
payments_account_info.payments_account_id
: Eine 16-stellige ID, mit der das mit der Abrechnungseinrichtung verknüpfte Zahlungskonto identifiziert wird.payments_account_info.payments_account_name
: Der Name des Zahlungskontos, das mit der Abrechnungseinrichtung verknüpft ist. Dieser Name wird auf monatlichen Rechnungen angegeben.payments_account_info.payments_profile_id
: Eine 12-stellige ID, mit der das mit der Abrechnungseinrichtung verknüpfte Zahlungsprofil identifiziert wird.
Wenn ein Zahlungskonto für die konsolidierte Abrechnung infrage kommt, können mehrere Google Ads-Konten auf derselben Rechnung gruppiert werden. Dazu wird in den Abrechnungseinrichtungen dasselbe zugrunde liegende Zahlungskonto verwendet.
Neue Abrechnungseinrichtungen erstellen
Sie können neue Abrechnungseinrichtungen mit vorhandenen Zahlungskonten oder mit Konten verknüpfen, die gleichzeitig erstellt wurden.
Bestehendes Zahlungskonto verwenden
Wenn Sie eine Verknüpfung mit einem vorhandenen Zahlungskonto herstellen möchten, legen Sie für payments_account
die Ressourcen-ID eines gültigen Zahlungskontos fest. Ändern Sie payments_account_info
jedoch nicht.
Sie können verfügbare Zahlungskonten mit der Methode PaymentsAccountService.ListPaymentsAccounts
auflisten. Welche PaymentsAccounts
zurückgegeben wird, hängt vom Verwaltungskonto ab, das Sie für die Authentifizierung verwenden.
Für jede PaymentsAccount
befindet sich die ID des zugehörigen Zahlungsverwaltungskontos im Feld paying_manager_customer
.
Neues Zahlungskonto verwenden
Legen Sie für eine Verknüpfung mit einem neuen Zahlungskonto in payments_account_info
die folgenden Felder fest (nicht payments_account
):
Im folgenden Beispiel wird gezeigt, wie Sie mit einer vorhandenen Zahlungsprofil-ID eine neue Abrechnungseinrichtung erstellen. Wie oben angegeben, wird dabei auch ein neues Zahlungskonto mit dem Namen My New Payments Account
erstellt.
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);
}
Wenn dies die erste Abrechnungseinrichtung ist, die einem Google Ads-Konto hinzugefügt wird, wird der Kunde damit über das referenzierte Zahlungsprofil für die Abrechnung angemeldet.
Status der Abrechnungseinrichtung
Neue BillingSetup
-Instanzen müssen genehmigt werden, bevor sie wirksam werden. Bis dahin hat das status
den Status PENDING
.
Ein BillingSetup
kann in einem der folgenden status
enthalten sein:
Status der Abrechnungseinrichtung | Beschreibung |
---|---|
PENDING |
Genehmigung ausstehend. |
APPROVED_HELD |
Genehmigt, aber das entsprechende erste Budget wurde nicht genehmigt. Dies ist nur bei Abrechnungseinrichtungen möglich, die für die monatliche Rechnungsstellung konfiguriert sind. |
APPROVED |
Die Einrichtung wurde genehmigt. |
CANCELLED |
Die Einrichtung wurde vom Nutzer vor der Genehmigung abgebrochen. |
Abrechnungseinrichtung eines Kontos abrufen
Wie die meisten anderen Entitäten in der Google Ads API wird ein BillingSetup
abgerufen, indem der GoogleAdsService.SearchStream
mit einer Google Ads Query Language-Abfrage abgefragt wird, die angibt, welche Felder zurückgegeben werden sollen.
Sobald Sie einen Verweis auf ein BillingSetup
erhalten haben, können Sie damit ein AccountBudgetProposal
-Objekt erstellen, wie unter Kontobudget beschrieben.
Ausstehende Abrechnungseinrichtung abbrechen
Ein BillingSetup
, der noch nicht angewendet wurde, kann mit dem Vorgang zum Entfernen abgebrochen werden. Abrechnungseinrichtungen können nur gekündigt werden, wenn ihre status
den Wert PENDING
haben oder wenn sie APPROVED
in der Zukunft beginnen.