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 BillingSetup tienen el siguiente formato:

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

enum (BillingSetupStatus)

Solo salida. El estado de la configuración de facturación.
paymentsAccountInfo

object (PaymentsAccountInfo)

Inmutable. 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 configures la facturación, se propagarán esta cuenta y paymentsAccount.
id

string (int64 format)

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

string

Inmutable. El nombre de 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 utiliza para registrarse con una cuenta de pagos existente (no se debe configurar paymentsAccountInfo). Cuando configures la facturación, se propagarán esta información y paymentsAccountInfo.

Campo de unión start_time. Cuando crees una nueva configuración de facturación, debería aplicarse la configuración. 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 se aprobó la configuración (consulta el estado) después de la hora de inicio solicitada, esta es la hora de aprobación. start_time puede ser una de las siguientes opciones:
startDateTime

string

Inmutable. Corresponde a la hora de 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. Indica la hora de inicio como 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 de inicio de la próxima configuración de facturación programada o POR SIEMPRE. Las direcciones (end_time) solo pueden ser una de las siguientes opciones:
endDateTime

string

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

enum (TimeType)

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

BillingSetupStatus

Son los posibles estados de una configuración de facturación.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. 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. 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

Es el 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 para ayudar a conciliar las facturas mensuales.

Este nombre se imprimirá en las facturas mensuales.
paymentsProfileId

string

Inmutable. Es un ID de 12 dígitos que se utiliza 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 presente en situaciones poco comunes, por ejemplo, cuando se celebró un acuerdo de responsabilidad secuencial.