BillingSetup

• JSON-Darstellung
• BillingSetupStatus
• PaymentsAccountInfo
  • JSON-Darstellung

Eine Abrechnungseinrichtung, die ein Zahlungskonto mit einem Werbetreibenden verknüpft. Eine Abrechnungseinrichtung ist für einen einzelnen Werbetreibenden spezifisch.

JSON-Darstellung

{ "resourceName": string, "status": enum (BillingSetupStatus), "paymentsAccountInfo": { object (PaymentsAccountInfo) }, "id": string, "paymentsAccount": string, // Union field start_time can be only one of the following: "startDateTime": string, "startTimeType": enum (TimeType) // End of list of possible types for union field start_time. // Union field end_time can be only one of the following: "endDateTime": string, "endTimeType": enum (TimeType) // End of list of possible types for union field end_time. }

Felder
resourceName	string Nicht veränderbar. Der Ressourcenname der Abrechnungseinrichtung. Ressourcennamen für die Abrechnungseinrichtung haben folgendes Format: customers/{customerId}/billingSetups/{billing_setup_id}
status	enum (BillingSetupStatus) Nur Ausgabe. Der Status der Abrechnungseinrichtung.
paymentsAccountInfo	object (PaymentsAccountInfo) Nicht veränderbar. Die Informationen zum Zahlungskonto, die mit dieser Abrechnungseinrichtung verknüpft sind. Bei der Einrichtung der Abrechnung wird damit ein neues Zahlungskonto registriert. In diesem Fall sollte „paymentsAccount“ nicht festgelegt werden. Beim Abrufen der Abrechnungseinrichtung werden dieses Feld und „paymentsAccount“ ausgefüllt.
id	string (int64 format) Nur Ausgabe. Die ID der Abrechnungseinrichtung.
paymentsAccount	string Nicht veränderbar. Der Ressourcenname des Zahlungskontos, das mit dieser Abrechnungseinrichtung verknüpft ist. Namen von Zahlungsressourcen haben folgendes Format: customers/{customerId}/paymentsAccounts/{paymentsAccountId} Beim Einrichten der Abrechnung wird dieses Konto verwendet, um sich mit einem vorhandenen Zahlungskonto zu registrieren. „paymentsAccountInfo“ sollte nicht festgelegt werden. Beim Abrufen der Abrechnungseinrichtung werden diese und paymentsAccountInfo ausgefüllt.
Union-Feld start_time. Wenn Sie eine neue Abrechnungseinrichtung erstellen, sollte die Einrichtung zu diesem Zeitpunkt wirksam werden. JETZT ist der einzige zulässige Startzeitpunkt, wenn der Kunde keine genehmigten Konfigurationen hat. Beim Abrufen einer vorhandenen Abrechnungseinrichtung ist dies die angeforderte Startzeit. Wurde die Einrichtung jedoch nach der angeforderten Startzeit genehmigt (siehe Status), ist dies der Genehmigungszeitpunkt. Für start_time ist nur einer der folgenden Werte zulässig:
startDateTime	string Nicht veränderbar. Das Startdatum und die Startzeit im Format JJJJ-MM-TT oder JJJJ-MM-TT HH:mm:ss. Es ist nur ein zukünftiger Zeitpunkt zulässig.
startTimeType	enum (TimeType) Nicht veränderbar. Die Startzeit als Typ. Es ist nur NOW zulässig.
Union-Feld end_time. Wann die Abrechnungseinrichtung endet bzw. endete. Dies ist entweder „FÜR IMMER“ oder der Beginn der nächsten geplanten Abrechnungseinrichtung. Für end_time ist nur einer der folgenden Werte zulässig:
endDateTime	string Nur Ausgabe. Das Enddatum und die Endzeit im Format JJJJ-MM-TT oder JJJJ-MM-TT HH:mm:ss.
endTimeType	enum (TimeType) Nur Ausgabe. Die Endzeit als Typ. Der einzige mögliche Wert ist „FOREVER“.

BillingSetupStatus

Die möglichen Status von BillingSetup.

Enums
UNSPECIFIED	Nicht angegeben.
UNKNOWN	Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
PENDING	Die Abrechnungseinrichtung muss noch genehmigt werden.
APPROVED_HELD	Die Abrechnungseinrichtung wurde genehmigt, das entsprechende erste Budget jedoch nicht. Das kann nur bei Abrechnungseinrichtungen auftreten, die für die monatliche Rechnungsstellung konfiguriert sind.
APPROVED	Die Abrechnungseinrichtung wurde genehmigt.
CANCELLED	Die Abrechnungseinrichtung wurde vor der Genehmigung vom Nutzer abgebrochen.

PaymentsAccountInfo

Container mit Zahlungskontoinformationen für diese Abrechnung.

JSON-Darstellung
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string }

Felder
paymentsAccountId	string Nur Ausgabe. Eine 16-stellige ID, mit der das Zahlungskonto identifiziert wird, das mit der Abrechnungseinrichtung verknüpft ist. Dieser muss als String mit Bindestrichen übergeben werden, z. B. „1234-5678-9012-3456“.
paymentsAccountName	string Nicht veränderbar. Der Name des Zahlungskontos, das mit der Abrechnungseinrichtung verknüpft ist. So kann der Nutzer einen aussagekräftigen Namen für ein Zahlungskonto angeben, um die monatlichen Rechnungen abzugleichen. Dieser Name wird auf den monatlichen Rechnungen gedruckt.
paymentsProfileId	string Nicht veränderbar. Eine 12-stellige ID, mit der das Zahlungsprofil identifiziert wird, das mit der Abrechnungseinrichtung verknüpft ist. Dieser muss als String mit Bindestriche übergeben werden, z. B. „1234-5678-9012“.
paymentsProfileName	string Nur Ausgabe. Der Name des Zahlungsprofils, das mit der Abrechnungseinrichtung verknüpft ist.
secondaryPaymentsProfileId	string Nur Ausgabe. Die ID eines sekundären Zahlungsprofils, die in seltenen Fällen verwendet wird, z. B. wenn eine Vereinbarung zur nachgelagerten Leistungsschuld getroffen wurde.