BillingSetup

Una configuración de facturación, que asocia una cuenta de pagos y un anunciante Una configuración de facturación es específica para un anunciante.

Representación 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.
}
Campos
resourceName

string

Inmutable. El nombre del recurso de la configuración de facturación. Los nombres de recursos de BillingSetup tienen el siguiente formato:

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

enum (BillingSetupStatus)

Solo salida. Es el estado de la configuración de facturación.
paymentsAccountInfo

object (PaymentsAccountInfo)

Inmutable. Es la información de la cuenta de pagos asociada con esta configuración de facturación. Cuando configuras la facturación, se usa para registrarse con una cuenta de pagos nueva (no se debe configurar paymentsAccount). Cuando se configura la facturación, se propagarán este elemento y paymentsAccount.
id

string (int64 format)

Solo salida. El ID de la configuración de facturación.
paymentsAccount

string

Inmutable. El nombre del recurso de la cuenta de pagos asociada con esta configuración de facturación. Los nombres de los recursos de pagos tienen el siguiente formato:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} Cuando se configura la facturación, se usa para registrarse con una cuenta de pagos existente (no se debe configurar paymentsAccountInfo). Cuando se configura la facturación, se propagarán este valor y paymentsAccountInfo.

Campo de unión start_time. Cuando cree una nueva configuración de facturación, esta es la fecha en la que la configuración debería aplicarse. AHORA es la única hora de inicio aceptable si el cliente no tiene ninguna configuración aprobada.

Cuando se recupera una configuración de facturación existente, esta es la hora de inicio solicitada. Sin embargo, si la configuración se aprobó (ver estado) después de la hora de inicio solicitada, este es el momento de aprobación. start_time puede ser una de las siguientes opciones:
startDateTime

string

Inmutable. Corresponde a la hora y la fecha de inicio en formato aaaa-MM-dd o aaaa-MM-dd HH:mm:ss. Solo se permite una hora futura.
startTimeType

enum (TimeType)

Inmutable. La hora de inicio como un tipo. Solo se permite AHORA.
Campo de unión end_time. Cuando finaliza o finaliza la configuración de facturación. Esta es la hora SIEMPRE o la hora de inicio de la próxima configuración de facturación programada. Las direcciones (end_time) solo pueden ser una de las siguientes opciones:
endDateTime

string

Solo salida. Corresponde a la fecha y hora de finalización en formato aaaa-MM-dd o aaaa-MM-dd HH:mm:ss.
endTimeType

enum (TimeType)

Solo salida. La hora de finalización como un tipo. El único valor posible es FOREVER.

BillingSetupStatus

Los posibles estados de una BillingSetup.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
PENDING La configuración de facturación está pendiente de aprobación.
APPROVED_HELD Se aprobó la configuración de facturación, pero el primer presupuesto correspondiente no se aprobó. Esto solo puede ocurrir para las configuraciones de facturación configuradas para la facturación mensual.
APPROVED Se aprobó la configuración de facturación.
CANCELLED El usuario canceló la configuración de facturación antes de la aprobación.

PaymentsAccountInfo

Contenedor de la información de la cuenta de pagos para esta facturación.

Representación JSON 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
Campos
paymentsAccountId

string

Solo salida. Es un ID de 16 dígitos que se utiliza para identificar la cuenta de pagos asociada con la configuración de facturación.

Se debe pasar como una cadena con guiones, por ejemplo, "1234-5678-9012-3456".
paymentsAccountName

string

Inmutable. Es el nombre de la cuenta de pagos asociada con la configuración de facturación.

Esto permite que el usuario especifique un nombre significativo para una cuenta de pagos a fin de ayudar a conciliar facturas mensuales.

Este nombre se imprimirá en las facturas mensuales.
paymentsProfileId

string

Inmutable. Es un ID de 12 dígitos que se usa para identificar el perfil de pagos asociado con la configuración de facturación.

Se debe pasar como una cadena con guiones, por ejemplo, "1234-5678-9012".
paymentsProfileName

string

Solo salida. Es el nombre del perfil de pagos asociado con la configuración de facturación.
secondaryPaymentsProfileId

string

Solo salida. Es un ID de perfil de pagos secundario que se presenta en situaciones poco comunes, por ejemplo, cuando se celebra un acuerdo de responsabilidad secuencial.