BillingSetup

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 von BillingSetup haben das folgende Format:

customers/{customerId}/billingSetups/{billing_setup_id}
status

enum (BillingSetupStatus)

Nur Ausgabe Der Status der Abrechnungseinrichtung.
paymentsAccountInfo

object (PaymentsAccountInfo)

Nicht veränderbar. Die Zahlungskontoinformationen, die mit dieser Abrechnungseinrichtung verknüpft sind. Beim Einrichten der Abrechnung wird dies für die Registrierung mit einem neuen Zahlungskonto verwendet. In diesem Fall sollte „paymentsAccount“ nicht festgelegt werden. Beim Einrichten einer Abrechnungseinrichtung werden dieses Feld und paymentsAccount dargestellt.
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 das folgende Format:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} Beim Einrichten der Abrechnung wird dies für die Anmeldung mit einem bestehenden Zahlungskonto verwendet. In diesem Fall sollte „paymentsAccountInfo“ nicht festgelegt werden. Beim Einrichten einer Abrechnungseinrichtung werden diese Daten und „paymentsAccountInfo“ ausgefüllt.

Union-Feld start_time. Wenn Sie eine neue Abrechnungseinrichtung erstellen, sollte diese ab diesem Zeitpunkt wirksam werden. Wenn der Kunde keine genehmigten Einrichtungen hat, ist JETZT die einzige akzeptable Startzeit.

Wenn eine vorhandene Abrechnungseinrichtung abgerufen wird, ist dies der angeforderte Beginn. Wurde die Einrichtung jedoch nach der angeforderten Startzeit genehmigt (siehe Status), ist dies der entsprechende Zeitpunkt. 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 eine Zeit in der Zukunft zulässig.
startTimeType

enum (TimeType)

Nicht veränderbar. Die Startzeit als Typ. Es ist nur JETZT zulässig.
Union-Feld end_time. Wenn die Abrechnungseinrichtung endet bzw. endet. Dies ist entweder 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 Enddatum und -uhrzeit im Format jjjj-MM-tt oder jjjj-MM-tt HH:mm:ss.
endTimeType

enum (TimeType)

Nur Ausgabe Die Endzeit als Typ. Der einzig mögliche Wert ist FOREVER.

BillingSetupStatus

Die möglichen Status einer Abrechnungseinrichtung.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
PENDING Die Genehmigung der Abrechnungseinrichtung steht noch aus.
APPROVED_HELD Die Abrechnungseinrichtung wurde genehmigt, das entsprechende erste Budget jedoch nicht. Dies ist nur bei Abrechnungseinrichtungen möglich, 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 zur Identifizierung des mit der Abrechnungseinrichtung verknüpften Zahlungskontos.

Er 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.

Dadurch kann der Nutzer einen aussagekräftigen Namen für ein Zahlungskonto angeben, um den Abgleich monatlicher Rechnungen zu vereinfachen.

Dieser Name wird auf den monatlichen Rechnungen angegeben.
paymentsProfileId

string

Nicht veränderbar. Eine 12-stellige ID, mit der das mit der Abrechnungseinrichtung verknüpfte Zahlungsprofil identifiziert werden kann.

Er muss als String mit Bindestrichen ü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 Eine sekundäre Zahlungsprofil-ID, die in ungewöhnlichen Situationen vorhanden ist, z. B. wenn eine Vereinbarung zur nachgelagerten Leistungsschuld vereinbart wurde.