Настройки выставления счетов — это связь на уровне аккаунта между аккаунтом Google Рекламы и аккаунтом в системе платежей (также известная как настройки выставления счетов ), которая фактически определяет, кому будут выставляться счета за расходы, понесенные в рамках бюджетов аккаунта в настройках выставления счетов. Каждому аккаунту в системе платежей соответствует один счет.
О платежных счетах
Каждый BillingSetup
определяет платёжный счёт, которому выставляются счета за расходы, понесённые в рамках его бюджетов. Этот платёжный счёт связан с платёжным профилем , который в конечном итоге отвечает за списание средств.
Настройки выставления счетов содержат как payments_account
, так и группу payments_account_info
, которые идентифицируют используемый счет Payments, включая следующее:
-
payments_account_info.payments_account_id
: 16-значный идентификатор, используемый для идентификации платежного счета, связанного с настройкой выставления счетов. -
payments_account_info.payments_account_name
: Имя платёжного счёта, связанного с настройками выставления счёта. Это имя указывается в ежемесячных счетах. -
payments_account_info.payments_profile_id
: 12-значный идентификатор, используемый для идентификации платежного профиля, связанного с настройкой выставления счетов.
Если учетная запись Payments имеет право на консолидированное выставление счетов , то несколько учетных записей Google Ads можно сгруппировать в одном счете, настроив их настройки выставления счетов на использование одной и той же базовой учетной записи Payments.
Создайте новые настройки выставления счетов
Вы можете привязать новые настройки выставления счетов к существующим платежным аккаунтам или к аккаунтам, созданным одновременно с вами.
Использовать существующий платежный аккаунт
Чтобы связать существующий платёжный аккаунт, укажите в payments_account
идентификатор ресурса действующего платёжного аккаунта. Не изменяйте payments_account_info
.
Вы можете получить список доступных платёжных аккаунтов с помощью метода PaymentsAccountService.ListPaymentsAccounts
. Возвращаемые PaymentsAccounts
зависят от учётной записи менеджера, используемой для аутентификации.
Для каждого PaymentsAccount
идентификатор его платящего менеджера находится в поле paying_manager_customer
.
Используйте новый платежный аккаунт
Чтобы связать новый платежный аккаунт, задайте следующие поля payments_account_info
( не payments_account
):
В следующем примере показано, как создать новую настройку платёжной системы на основе существующего идентификатора платёжного профиля. Как уже упоминалось, при этом также создаётся новый платёжный счёт с именем My New Payments Account
.
BillingSetup bsetup = BillingSetup.newBuilder()
.setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
.setPaymentsAccountName("My New Payments Account")
.setPaymentsProfileId("1234-5678-9012")
.build())
.setStartTimeType(TimeType.NOW)
.build();
BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();
try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
.getBillingSetupServiceClient()) {
MutateBillingSetupResponse response =
billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}
Если это первая настройка выставления счетов, добавляемая в аккаунт Google Ads, то это фактически подпишет клиента на выставление счетов с использованием указанного платежного профиля.
Статус настройки выставления счетов
Новые экземпляры BillingSetup
подлежат утверждению до вступления в силу. До этого момента они находятся в status
PENDING
.
BillingSetup
может находиться в одном из следующих status
:
Статус настройки выставления счетов | Описание |
---|---|
PENDING | Ожидает одобрения. |
APPROVED_HELD | Утверждён, но соответствующий первый бюджет ещё не утвержден. Это возможно только для настроек выставления счетов с ежемесячным выставлением счетов. |
APPROVED | Установка одобрена. |
CANCELLED | Настройка была отменена пользователем до одобрения. |
Получить настройки выставления счетов для учетной записи
Как и большинство других сущностей в API Google Ads, BillingSetup
извлекается путем запроса к GoogleAdsService.SearchStream
с использованием запроса Google Ads Query Language, который указывает, какие поля следует возвращать.
Получив ссылку на BillingSetup
, вы можете использовать ее для создания AccountBudgetProposal
, как описано в разделе Бюджет счета .
Отменить отложенную настройку выставления счетов
BillingSetup
, которые ещё не вступили в силу, можно отменить с помощью операции удаления. Настройки биллинга можно отменить только в том случае, если они находятся в status
PENDING
или если они APPROVED
и вступят в силу в будущем.