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

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