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 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. Quando imposti la fatturazione, questo viene utilizzato per registrarti con un nuovo account pagamenti e non deve essere impostato l'account pagamenti. Quando crei una configurazione di fatturazione, questo e l'account pagamenti verranno 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 di pagamento hanno il seguente formato:

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

Campo di unione start_time. Quando crei una nuova configurazione di fatturazione, è il momento in cui dovrebbe essere applicata. 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 lo stato) dopo l'ora di inizio richiesta, questa è la data e 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. Il momento in cui la configurazione di fatturazione è terminata. ovvero 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. L'ora di fine come tipo. L'unico valore possibile è FOREVER.

BillingSetupStatus

Gli stati possibili 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 è stato approvato. Questo può avvenire 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 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 facilita 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 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.