Хотите поделиться своим мнением об API Google Рекламы? Зарегистрируйтесь , чтобы получить приглашение принять участие в исследовании пользователей!

Эта страница переведена с помощью Cloud Translation API.

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

Настройка выставления счетов — это связь на уровне аккаунта между аккаунтом Google Ads и аккаунтом Payments (также известная как настройка выставления счетов ), которая эффективно определяет, кому выставляются счета за расходы, понесенные в рамках бюджетов аккаунта настройки выставления счетов. Каждый аккаунт Payments соответствует одному счету.

О платежных счетах

Каждый BillingSetup определяет счет Payments, который получает счета за расходы, понесенные его бюджетами счетов. Этот счет Payments связан с профилем Payments , который в конечном итоге отвечает за расходы.

Настройки выставления счетов содержат как поле payments_account , так и группу полей payments_account_info , которые идентифицируют используемый платежный счет, включая следующее:

payments_account_info.payments_account_id : 16-значный идентификатор, используемый для идентификации платежного счета, связанного с настройкой выставления счетов.
payments_account_info.payments_account_name : Имя счета Payments, связанного с настройкой выставления счетов. Это имя печатается в ежемесячных счетах.
payments_account_info.payments_profile_id : 12-значный идентификатор, используемый для идентификации платежного профиля, связанного с настройкой выставления счетов.

Если платежный аккаунт соответствует требованиям для консолидированного выставления счетов , то несколько аккаунтов Google Ads можно объединить в один счет, настроив их настройки выставления счетов на использование одного и того же базового платежного аккаунта.

Создайте новые настройки выставления счетов

Вы можете привязать новые настройки выставления счетов к существующим платежным аккаунтам или к аккаунтам, созданным одновременно.

Используйте существующий платежный аккаунт

Чтобы связать существующий счет Payments, установите payments_account на идентификатор ресурса действительного счета Payments. Однако не изменяйте 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 для начала в будущем.

Обзор

Бюджет аккаунта