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

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

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

Обзор

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