Achtung:Sie lesen die Dokumentation für die REST-Schnittstelle der API. Die meisten unserer offiziellen Clientbibliotheken verwenden gRPC. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

BillingSetup

JSON-Darstellung
BillingSetupStatus
PaymentsAccountInfo
- JSON-Darstellung

Eine Abrechnungseinrichtung, die ein Zahlungskonto mit einem Werbetreibenden verknüpft. Eine Abrechnungseinrichtung gilt nur für einen Werbetreibenden.

JSON-Darstellung

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`. }

{
  "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. BillingSetup-Ressourcennamen 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 mit dieser Abrechnungseinrichtung verknüpften Zahlungskontoinformationen. Beim Einrichten der Abrechnung wird dies für die Anmeldung mit einem neuen Zahlungskonto verwendet. Das „paymentsAccount“-Konto sollte nicht festgelegt werden. Bei der Abrechnungseinrichtung werden dieses Feld und das „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 das folgende Format: `customers/{customerId}/paymentsAccounts/{paymentsAccountId}` Wird beim Einrichten der Abrechnung verwendet, um sich mit einem bestehenden Zahlungskonto zu registrieren (paymentsAccountInfo sollte nicht festgelegt werden). Bei der Abrechnungseinrichtung werden dieses Feld und die paymentsAccountInfo ausgefüllt.
Union-Feld `start_time`. Wenn Sie eine neue Abrechnungseinrichtung erstellen, sollte diese zu diesem Zeitpunkt wirksam werden. JETZT ist die einzige zulässige Startzeit, wenn der Kunde keine genehmigten Einrichtungen hat. Wenn eine bestehende Abrechnungseinrichtung abgerufen wird, ist dies die angeforderte Startzeit. Wurde die Einrichtung jedoch nach der angeforderten Startzeit genehmigt (siehe Status), ist dies die Genehmigungszeit. 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`. Wann die Abrechnungseinrichtung endet / 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 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 einzig mögliche Wert ist FOREVER.

BillingSetupStatus

Die möglichen Status einer BillingSetup-Funktion.

Enums
`UNSPECIFIED`	Nicht angegeben.
`UNKNOWN`	Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert 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 erscheint auf den monatlichen Rechnungen.
`paymentsProfileId`	`string` Nicht veränderbar. Eine 12-stellige ID zur Identifizierung des Zahlungsprofils, das mit der Abrechnungseinrichtung verknüpft ist. Diese 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 seltenen Fällen zur Verfügung steht, z. B. wenn eine Vereinbarung zur nachgelagerten Leistungsschuld vereinbart wurde.