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 de 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. Es el nombre del recurso de la configuración de facturación. Los nombres de los recursos 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, esta información se usa para registrarte con una nueva cuenta de pagos (y, luego, no se debe configurar paymentsAccount). Cuando obtengas una configuración de facturación, se propagarán este elemento y paymentsAccount.
id

string (int64 format)

Solo salida. Es el ID de la configuración de facturación.
paymentsAccount

string

Inmutable. Es 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 (y no se debe configurar paymentsAccountInfo). Cuando se obtenga una configuración de facturación, se propagarán este elemento y paymentsAccountInfo.

Campo de unión start_time. Cuando crees una nueva configuración de facturación, la configuración debería aplicarse en ese momento. 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ó (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. La fecha y hora de inicio en formato aaaa-MM-dd o aaaa-MM-dd HH:mm:ss Solo se permite una hora en el futuro.
startTimeType

enum (TimeType)

Inmutable. La hora de inicio como un tipo. Solo se permite NOW.
Campo de unión end_time. Cuándo finaliza o finalizó la configuración de facturación Es FOREVER 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. Es 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 tipo. El único valor posible es FOREVER.

BillingSetupStatus

Los estados posibles de un BillingSetup.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN Solo se usa 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 no el primer presupuesto correspondiente. 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 usa 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 usa para identificar el perfil de pagos asociado con la configuración de facturación.

Debe pasarse 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. Un ID de perfil de pagos secundario presente en situaciones poco comunes, por ejemplo, cuando se ha acordado un acuerdo de responsabilidad secuencial.