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

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

• payments_account_name
• payments_profile_id

В следующем примере показано, как создать новые настройки выставления счетов на основе существующего идентификатора профиля платежей. Как указывалось ранее, это также создаст новый платежный аккаунт с именем 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 :

Получить настройки выставления счетов для учетной записи

Как и большинство других объектов в API Google Ads, объект BillingSetup извлекается путем запроса к GoogleAdsService.SearchStream с использованием запроса на языке запросов Google Ads, который указывает, какие поля следует вернуть.

Получив ссылку на BillingSetup , вы можете использовать ее для создания AccountBudgetProposal , как описано в разделе «Бюджет счета» .

Отменить ожидающую настройку выставления счетов

BillingSetup которые еще не вступили в силу, можно отменить с помощью операции удаления. Настройки выставления счетов можно отменить только в том случае, если их status — PENDING или если они APPROVED для запуска в будущем.