Настройка выставления счетов – это связь на уровне аккаунта между аккаунтом 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-значный идентификатор, используемый для идентификации профиля платежей, связанного с настройкой выставления счетов.
Если для платежного аккаунта разрешено использование консолидированных счетов , то несколько аккаунтов Google Рекламы можно сгруппировать в одном счете, настроив для них настройки выставления счетов на использование одного и того же базового платежного аккаунта.
Создание новых платежных настроек
Вы можете связать новые платежные настройки с существующими платежными аккаунтами или с аккаунтами, созданными одновременно.
Использование существующего платежного аккаунта
Чтобы связать существующую платежную учетную запись, установите для 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 Рекламы, клиент фактически зарегистрируется для выставления счетов с использованием указанного платежного профиля.
Статус настройки платежных данных
Новые экземпляры BillingSetup
подлежат утверждению, прежде чем они вступят в силу. До этого момента их status
находится в состоянии PENDING
.
BillingSetup
может находиться в одном из следующих status
:
Статус настройки биллинга | Описание |
---|---|
PENDING | Ожидает одобрения. |
APPROVED_HELD | Утвержден, но соответствующий первый бюджет еще не принят. Это может произойти только для настроек выставления счетов, настроенных для ежемесячного выставления счетов. |
APPROVED | Установка одобрена. |
CANCELLED | Установка была отменена пользователем до утверждения. |
Получение платежных данных аккаунта
Как и большинство других объектов в API Google Рекламы, BillingSetup
извлекается путем запроса GoogleAdsService.SearchStream
с использованием запроса языка запросов Google Рекламы, который определяет, какие поля возвращаются.
Получив ссылку на BillingSetup
, вы можете использовать ее для создания AccountBudgetProposal
, как описано в разделе «Бюджет учетной записи» .
Отмена ожидающей настройки платежа
BillingSetup
, которая еще не вступила в силу, может быть отменена с помощью операции удаления. Настройки выставления счетов можно отменить только в том случае, если они находятся status
PENDING
или если их запуск APPROVED
в будущем.