Настройка оплаты

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