Настройки выставления счетов — это связь на уровне аккаунта между аккаунтом Google Ads и аккаунтом платежей (также известная как настройки выставления счетов ), которая фактически определяет, кому выставляются счета за расходы, понесенные в соответствии с бюджетами аккаунта, заданными в настройках выставления счетов. Каждому аккаунту платежей соответствует один счет-фактура.
О платежных счетах
В каждом BillingSetup идентифицируется платежный аккаунт, которому выставляются счета за расходы, понесенные в соответствии с бюджетами этого аккаунта. Этот платежный аккаунт связан с платежным профилем , который в конечном итоге отвечает за начисление платежей.
В настройках выставления счетов содержатся поле payments_account и группа полей payments_account_info , которые идентифицируют используемый платежный счет, включая следующие:
-
payments_account_info.payments_account_id: 16-значный идентификатор, используемый для идентификации платежного счета, связанного с настройкой выставления счетов. -
payments_account_info.payments_account_name: Название платежного счета, связанного с настройками выставления счетов. Это название отображается в ежемесячных счетах. -
payments_account_info.payments_profile_id: 12-значный идентификатор, используемый для идентификации профиля платежей, связанного с настройками выставления счетов.
Если для платежного аккаунта подходит консолидированная оплата , то несколько аккаунтов Google Ads можно объединить в один счет, настроив параметры выставления счетов таким образом, чтобы они использовали один и тот же базовый платежный аккаунт.
Создание новых настроек выставления счетов
Вы можете связать новые настройки выставления счетов с существующими платежными учетными записями или с учетными записями, созданными одновременно.
Используйте существующий платежный аккаунт.
Для связи с существующим платежным аккаунтом установите 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, который указывает, какие поля следует вернуть.
Получив ссылку на BillingSetup , вы можете использовать ее для создания AccountBudgetProposal , как описано в разделе «Бюджет счета» .
Отменить ожидающую настройку выставления счетов
BillingSetup которые еще не вступили в силу, можно отменить с помощью операции удаления. Настройки выставления счетов можно отменить только в том случае, если их status — PENDING или если они APPROVED для запуска в будущем.