BillingSetup

Настройка выставления счетов, которая связывает платежный аккаунт и рекламодателя. Платежные настройки индивидуальны для одного рекламодателя.

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.
}
Поля
resource Name

string

Неизменяемый. Имя ресурса настройки выставления счетов. Имена ресурсов BillingSetup имеют вид:

customers/{customerId}/billingSetups/{billing_setup_id}

status

enum ( BillingSetupStatus )

Только вывод. Статус настройки выставления счетов.

payments Account Info

object ( PaymentsAccountInfo )

Неизменяемый. Информация платежного аккаунта, связанная с этой настройкой выставления счетов. При настройке выставления счетов это используется для регистрации нового платежного аккаунта (и тогда PaymentAccount не должен быть установлен). При настройке выставления счетов этот и PaymentAccount будут заполнены.

id

string ( int64 format)

Только вывод. Идентификатор платежной системы.

payments Account

string

Неизменяемый. Имя ресурса платежного аккаунта, связанного с этой настройкой выставления счетов. Имена платежных ресурсов имеют вид:

customers/{customerId}/paymentsAccounts/{paymentsAccountId} При настройке выставления счетов он используется для регистрации с использованием существующего платежного аккаунта (и тогда платежиAccountInfo не следует задавать). При настройке выставления счетов это значение и PaymentAccountInfo будут заполнены.

Поле объединения start_time . При создании новой настройки выставления счетов именно в этот момент настройки должны вступить в силу. СЕЙЧАС — единственное приемлемое время начала, если у клиента нет утвержденных настроек.

При получении существующих платежных данных это запрошенное время начала. Однако если установка была одобрена (см. статус) после запрошенного времени начала, то это время утверждения. start_time может быть только одним из следующих:

start Date Time

string

Неизменяемый. Дата и время начала в формате гггг-ММ-дд или гггг-ММ-дд ЧЧ:мм:сс. Разрешено только будущее время.

start Time Type

enum ( TimeType )

Неизменяемый. Время начала как тип. Разрешено только СЕЙЧАС.

Поле объединения end_time . Когда заканчивается/закончилась настройка биллинга. Это либо НАВСЕГДА, либо время начала следующей запланированной настройки выставления счетов. end_time может быть только одним из следующих:
end Date Time

string

Только вывод. Дата окончания в формате гггг-ММ-дд или гггг-ММ-дд ЧЧ:мм:сс.

end Time Type

enum ( TimeType )

Только вывод. Время окончания как тип. Единственное возможное значение — НАВСЕГДА.

Статус настройки выставления счетов

Возможные статусы BillingSetup.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
PENDING Настройка платежных данных ожидает одобрения.
APPROVED_HELD Настройки платежных данных утверждены, но соответствующий первый бюджет еще не принят. Это может произойти только для настроек выставления счетов, настроенных для ежемесячного выставления счетов.
APPROVED Платежные настройки одобрены.
CANCELLED Настройка выставления счетов была отменена пользователем до утверждения.

ПлатежиИнформация об аккаунте

Контейнер информации о платежном счете для этого платежа.

JSON-представление 
{
  "paymentsAccountId": string,
  "paymentsAccountName": string,
  "paymentsProfileId": string,
  "paymentsProfileName": string,
  "secondaryPaymentsProfileId": string
}
Поля
payments Account Id

string

Только вывод. 16-значный идентификатор, используемый для идентификации платежного аккаунта, связанного с настройками выставления счетов.

Его необходимо передать в виде строки с дефисами, например «1234-5678-9012-3456».

payments Account Name

string

Неизменяемый. Имя платежного аккаунта, связанного с настройкой выставления счетов.

Это позволяет пользователю указать значимое имя для платежного счета, чтобы облегчить сверку ежемесячных счетов.

Это имя будет печататься в ежемесячных счетах.

payments Profile Id

string

Неизменяемый. 12-значный идентификатор, используемый для идентификации платежного профиля, связанного с настройкой выставления счетов.

Его необходимо передать в виде строки с дефисами, например «1234-5678-9012».

payments Profile Name

string

Только вывод. Название платежного профиля, связанного с настройкой выставления счетов.

secondary Payments Profile Id

string

Только вывод. Идентификатор профиля вторичных платежей присутствует в редких ситуациях, например, при заключении соглашения о последовательной ответственности.