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 della fatturazione.

paymentsAccountInfo

object (PaymentsAccountInfo)

Immutabile. I dati dell'account pagamenti associati a questa configurazione di fatturazione. Durante l'impostazione della fatturazione, questo indirizzo viene utilizzato per registrarti con un nuovo account pagamenti (e non deve essere impostato l'account pagamenti). Una volta completata la configurazione di fatturazione, verranno compilati questo account e quello dei pagamenti.

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 di pagamento hanno il seguente formato:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} Durante l'impostazione della fatturazione, questo indirizzo viene utilizzato per la registrazione con un account pagamenti esistente e non deve essere impostato su paymentsAccountInfo. Quando crei una configurazione di fatturazione, questo campo e paymentsAccountInfo vengono compilati.

Campo di unione start_time. Quando crei una nuova configurazione di fatturazione, è in questo momento che deve essere applicata la configurazione. ORA è 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. L'ora di data di inizio nel formato aaaa-MM-gg o aaaa-MM-gg HH:mm:ss. È consentito solo un orario futuro.

startTimeType

enum (TimeType)

Immutabile. L'ora di inizio come tipo. È consentito solo NOW.

Campo di unione end_time. Quando termina o termina la configurazione di 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. L'ora di fine nel formato aaaa-MM-gg o aaaa-MM-gg HH:mm:ss.

endTimeType

enum (TimeType)

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

BillingSetupStatus

I possibili stati di un'impostazione 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 il primo budget corrispondente non lo è. Questo può avvenire solo per le configurazioni di fatturazione configurate con la fatturazione mensile.
APPROVED La configurazione di fatturazione è stata approvata.
CANCELLED La configurazione della 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 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 che consenta di riconciliare le 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 trasmesso come stringa con 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 non comuni, ad esempio quando è stato stipulato un contratto di responsabilità sequenziale.