Eine Rechnungseinrichtung ist eine Verknüpfung auf Kontoebene zwischen einem Google Ads-Konto und einem Zahlungskonto (auch Rechnungseinrichtung genannt). Sie legt fest, wer für die Kosten in Rechnung gestellt wird, die durch die Kontobudgets der Rechnungseinrichtung anfallen. Jedes Zahlungskonto entspricht einer einzelnen Rechnung.
Zahlungskonten
Jedes BillingSetup
identifiziert ein Zahlungskonto, für das die Kosten in Rechnung gestellt werden, die durch die Kontobudgets entstehen. Dieses Zahlungskonto ist mit einem Zahlungsprofil verknüpft, das letztendlich für die Gebühren verantwortlich ist.
Rechnungseinrichtungen enthalten sowohl ein Feld payments_account
als auch eine Gruppe von Feldern payments_account_info
, die das verwendete Zahlungsprofil identifizieren, darunter:
payments_account_info.payments_account_id
: Eine 16-stellige ID zur Identifizierung des Zahlungsprofils, das mit der Abrechnungseinrichtung verknüpft ist.payments_account_info.payments_account_name
: Der Name des mit der Abrechnungseinrichtung verknüpften Zahlungskontos. Dieser Name wird auf monatlichen Rechnungen angegeben.payments_account_info.payments_profile_id
: Eine 12-stellige ID zur Identifizierung des Zahlungsprofils, das mit der Abrechnungseinrichtung verknüpft ist.
Wenn ein Zahlungskonto für die konsolidierte Abrechnung infrage kommt, können mehrere Google Ads-Konten auf derselben Rechnung zusammengefasst werden. Dazu müssen Sie für die Abrechnungseinstellungen die Verwendung desselben zugrunde liegenden Zahlungskontos festlegen.
Neue Abrechnungseinrichtungen erstellen
Sie können neue Abrechnungseinrichtungen mit vorhandenen oder gleichzeitig erstellten Zahlungskonten verknüpfen.
Vorhandenes Zahlungskonto verwenden
Wenn Sie ein bestehendes Zahlungskonto verknüpfen möchten, legen Sie payments_account
auf die Ressourcen-ID eines gültigen Zahlungskontos fest. Ändern Sie payments_account_info
jedoch nicht.
Sie können verfügbare Zahlungskonten mit der PaymentsAccountService.ListPaymentsAccounts
-Methode auflisten. Die zurückgegebenen PaymentsAccounts
hängen vom Verwaltungskonto ab, das Sie für die Authentifizierung verwenden.
Für jede PaymentsAccount
ist die ID des zahlenden Managers im Feld paying_manager_customer
enthalten.
Neues Zahlungsprofil verwenden
Wenn Sie eine Verknüpfung mit einem neuen Zahlungskonto herstellen möchten, legen Sie die folgenden Felder in payments_account_info
fest (nicht payments_account
):
Im folgenden Beispiel wird gezeigt, wie Sie eine neue Abrechnungseinrichtung anhand einer vorhandenen Zahlungen-Profil-ID erstellen. Wie bereits erwähnt, wird dadurch 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 dadurch für die Abrechnung über das referenzierte Zahlungsprofil registriert.
Status der Abrechnungseinrichtung
Neue BillingSetup
-Instanzen müssen genehmigt werden, bevor sie in Kraft treten. Bis dahin befindet sich status
im Status PENDING
.
Ein BillingSetup
kann einen der folgenden status
haben:
Status der Abrechnungseinrichtung | Beschreibung |
---|---|
PENDING |
Genehmigung ausstehend. |
APPROVED_HELD |
Genehmigt, aber das entsprechende erste Budget nicht. Dies kann nur bei Abrechnungseinrichtungen mit monatlicher Rechnungsstellung passieren. |
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 GoogleAdsService.SearchStream
mit einer Google Ads Query Language-Abfrage abgefragt wird, in der die zurückzugebenden Felder angegeben werden.
Sobald Sie einen Verweis auf ein BillingSetup
erhalten haben, können Sie damit ein AccountBudgetProposal
erstellen, wie unter Account Budget beschrieben.
Ausstehende Abrechnungseinrichtung kündigen
Eine BillingSetup
, die noch nicht in Kraft getreten ist, kann mit dem Vorgang „Entfernen“ abgebrochen werden. Abrechnungseinrichtungen können nur gekündigt werden, wenn ihr status
PENDING
ist oder wenn sie APPROVED
sind und erst in der Zukunft beginnen.