BillingSetup

Una configurazione di fatturazione che associa un account pagamenti e un inserzionista. Una configurazione di fatturazione è specifica per un inserzionista.

Rappresentazione JSON 
{
  "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.
}
Campi
resourceName

string

Immutabile. Il nome della risorsa della configurazione di fatturazione. I nomi delle risorse BillingSetup hanno il seguente formato:

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

enum (BillingSetupStatus)

Solo output. Lo stato della configurazione di fatturazione.
paymentsAccountInfo

object (PaymentsAccountInfo)

Immutabile. I dati dell'account pagamenti associati a questa configurazione di fatturazione. Quando imposti la fatturazione, questa opzione viene utilizzata per la registrazione con un nuovo account pagamenti (quindi l'account pagamenti non deve essere impostato). Quando viene eseguita una configurazione di fatturazione, questo campo e paymentsAccount vengono compilati.
id

string (int64 format)

Solo output. L'ID della configurazione di fatturazione.
paymentsAccount

string

Immutabile. Il nome della risorsa dell'account pagamenti associato a questa configurazione di fatturazione. I nomi delle risorse Payments hanno il seguente formato:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} Quando configuri la fatturazione, questo valore viene utilizzato per registrarti con un account pagamenti esistente (quindi paymentsAccountInfo non deve essere impostato). Quando viene eseguita la configurazione della fatturazione, questo campo e paymentsAccountInfo vengono compilati.

Campo unione start_time. Quando crei una nuova configurazione di fatturazione, è in questo momento che la configurazione dovrebbe essere applicata. NOW è l'unica ora di inizio accettabile se il cliente non ha configurazioni approvate.

Quando recuperi una configurazione di fatturazione esistente, questa è l'ora di inizio richiesta. Tuttavia, se la configurazione è stata approvata (vedi stato) dopo l'ora di inizio richiesta, questa è l'ora di approvazione. start_time può essere solo uno dei seguenti:
startDateTime

string

Immutabile. La data e l'ora di inizio nel formato aaaa-MM-gg o aaaa-MM-gg HH:mm:ss. È consentito un orario futuro.
startTimeType

enum (TimeType)

Immutabile. L'ora di inizio indicata come tipo. È consentito solo il valore NOW.
Campo unione end_time. Al termine della configurazione della fatturazione. Può essere SEMPRE o l'ora di inizio della successiva configurazione di fatturazione pianificata. end_time può essere solo uno dei seguenti:
endDateTime

string

Solo output. La data e l'ora di fine nel formato aaaa-MM-gg o aaaa-MM-gg HH:mm:ss.
endTimeType

enum (TimeType)

Solo output. L'ora di fine indicata come tipo. L'unico valore possibile è FOREVER.

BillingSetupStatus

Gli stati possibili di un BillingSetup.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
PENDING La configurazione di fatturazione è in attesa di approvazione.
APPROVED_HELD La configurazione di fatturazione è stata approvata, ma non il primo budget corrispondente. Questo può accadere solo per le configurazioni di fatturazione configurate per la fatturazione mensile.
APPROVED La configurazione di fatturazione è stata approvata.
CANCELLED La configurazione di fatturazione è stata annullata dall'utente prima dell'approvazione.

PaymentsAccountInfo

Contenitore dei dati dell'account pagamenti per questa fatturazione.

Rappresentazione JSON 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
Campi
paymentsAccountId

string

Solo output. Un ID di 16 cifre utilizzato per identificare l'account pagamenti associato alla configurazione di fatturazione.

Deve essere passato come stringa con i trattini, ad esempio "1234-5678-9012-3456".
paymentsAccountName

string

Immutabile. Il nome dell'account pagamenti associato alla configurazione di fatturazione.

In questo modo, l'utente può specificare un nome significativo per un account pagamenti per facilitare la riconciliazione delle fatture mensili.

Questo nome verrà stampato nelle fatture mensili.
paymentsProfileId

string

Immutabile. Un ID di 12 cifre utilizzato per identificare il profilo pagamenti associato alla configurazione di fatturazione.

Deve essere passato come stringa con i trattini, ad esempio "1234-5678-9012".
paymentsProfileName

string

Solo output. Il nome del profilo pagamenti associato alla configurazione di fatturazione.
secondaryPaymentsProfileId

string

Solo output. Un ID profilo pagamenti secondario presente in situazioni insolite, ad esempio quando è stato stipulato un contratto di responsabilità sequenziale.