Настройки выставления счетов — это связь на уровне аккаунта между аккаунтом 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 и вступят в силу в будущем.