Внимание! Вы просматриваете документацию по интерфейсу REST API. Большинство наших официальных клиентских библиотек используют gRPC. Подробнее см. в разделе Введение в REST .

Эта страница переведена с помощью Cloud Translation API.

BillingSetup

JSON-представление
Статус настройки выставления счетов
ПлатежиИнформация об аккаунте
- JSON-представление

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

JSON-представление

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`. }

{
  "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.
}

Поля
`resourceName`	`string` Неизменный. Имя ресурса настройки выставления счетов. Имена ресурсов BillingSetup имеют вид: `customers/{customerId}/billingSetups/{billing_setup_id}`
`status`	`enum ( BillingSetupStatus )` Только вывод. Статус настройки выставления счетов.
`paymentsAccountInfo`	`object ( PaymentsAccountInfo )` Неизменный. Информация платежного аккаунта, связанная с этой настройкой выставления счетов. При настройке выставления счетов это используется для регистрации нового платежного аккаунта (и тогда PaymentAccount не должен быть установлен). При настройке выставления счетов этот и PaymentAccount будут заполнены.
`id`	`string ( int64 format)` Только вывод. Идентификатор платежной системы.
`paymentsAccount`	`string` Неизменный. Имя ресурса платежного аккаунта, связанного с этой настройкой выставления счетов. Имена платежных ресурсов имеют вид: `customers/{customerId}/paymentsAccounts/{paymentsAccountId}` При настройке выставления счетов он используется для регистрации с использованием существующего платежного аккаунта (и тогда платежиAccountInfo не следует задавать). При настройке выставления счетов это значение и PaymentAccountInfo будут заполнены.
Поле объединения `start_time` . При создании новой настройки выставления счетов именно в этот момент настройки должны вступить в силу. СЕЙЧАС — единственное приемлемое время начала, если у клиента нет утвержденных настроек. При получении существующих платежных данных это запрошенное время начала. Однако если установка была одобрена (см. статус) после запрошенного времени начала, то это время утверждения. `start_time` может быть только одним из следующих:
`startDateTime`	`string` Неизменный. Дата и время начала в формате гггг-ММ-дд или гггг-ММ-дд ЧЧ:мм:сс. Разрешено только будущее время.
`startTimeType`	`enum ( TimeType )` Неизменный. Время начала как тип. Разрешено только СЕЙЧАС.
Поле объединения `end_time` . Когда заканчивается/закончилась настройка биллинга. Это либо НАВСЕГДА, либо время начала следующей запланированной настройки выставления счетов. `end_time` может быть только одним из следующих:
`endDateTime`	`string` Только вывод. Дата окончания в формате гггг-ММ-дд или гггг-ММ-дд ЧЧ:мм:сс.
`endTimeType`	`enum ( TimeType )` Только вывод. Время окончания как тип. Единственное возможное значение — НАВСЕГДА.

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

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

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

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

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

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

Поля
`paymentsAccountId`	`string` Только вывод. 16-значный идентификатор, используемый для идентификации платежного аккаунта, связанного с настройками выставления счетов. Его необходимо передать в виде строки с дефисами, например «1234-5678-9012-3456».
`paymentsAccountName`	`string` Неизменный. Имя платежного аккаунта, связанного с настройкой выставления счетов. Это позволяет пользователю указать значимое имя для платежного счета, чтобы облегчить сверку ежемесячных счетов. Это имя будет печататься в ежемесячных счетах.
`paymentsProfileId`	`string` Неизменный. 12-значный идентификатор, используемый для идентификации платежного профиля, связанного с настройкой выставления счетов. Его необходимо передать в виде строки с дефисами, например «1234-5678-9012».
`paymentsProfileName`	`string` Только вывод. Название платежного профиля, связанного с настройкой выставления счетов.
`secondaryPaymentsProfileId`	`string` Только вывод. Идентификатор профиля вторичных платежей присутствует в редких ситуациях, например, при заключении соглашения о последовательной ответственности.