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

Настройки выставления счетов

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

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

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

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

payments_account_info.payments_account_id : 16-значный идентификатор в виде строки с дефисами (например, "1234-5678-9012-3456" ), используемый для идентификации платежного счета, связанного с настройками выставления счетов.
payments_account_info.payments_account_name : Название платежного счета, связанного с настройками выставления счетов. Это название отображается в ежемесячных счетах.
payments_account_info.payments_profile_id : 12-значный идентификатор в виде строки с дефисами (например, "1234-5678-9012" ), используемый для идентификации профиля платежей, связанного с настройками выставления счетов.

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

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

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

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

Для связи с существующим платежным аккаунтом установите payments_account равным имени ресурса действительного платежного аккаунта (например, customers/{customer_id}/paymentsAccounts/{payments_account_id} ). Однако не изменяйте payments_account_info .

Вы можете получить список доступных платежных счетов с помощью метода PaymentsAccountService.ListPaymentsAccounts . Возвращаемые объекты PaymentsAccount зависят от учетной записи менеджера, используемой для аутентификации.

Для каждого PaymentsAccount имя ресурса его платежного менеджера находится в поле paying_manager_customer .

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

Для привязки к новому платежному аккаунту задайте следующие поля в payments_account_info ( не задавайте значение payments_account ):

В следующем примере показано, как создать новые настройки выставления счетов на основе существующего идентификатора профиля платежей. Как указывалось ранее, это также создаст новый платежный аккаунт с именем My New Payments Account .

BillingSetup billingSetup =
    BillingSetup.newBuilder()
        .setPaymentsAccountInfo(
            PaymentsAccountInfo.newBuilder()
                .setPaymentsAccountName("My New Payments Account")
                .setPaymentsProfileId("1234-5678-9012")
                .build())
        .setStartTimeType(TimeTypeEnum.TimeType.NOW)
        .build();

BillingSetupOperation operation =
    BillingSetupOperation.newBuilder().setCreate(billingSetup).build();

try (BillingSetupServiceClient billingSetupServiceClient =
    googleAdsClient.getBillingSetupServiceClient()) {
  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(
          Long.toString(customerId), operation);
}

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

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

Новые экземпляры BillingSetup подлежат утверждению, прежде чем они вступят в силу. До этого момента их status находится в состоянии PENDING .

BillingSetup может иметь одно из следующих значений status :

`BillingSetupStatus`	Описание
`PENDING`	Ожидается одобрение.
`APPROVED_HELD`	Одобрено, но соответствующий первый бюджет не утвержден. Это может произойти только для настроек выставления счетов, ориентированных на ежемесячное выставление счетов.
`APPROVED`	Настройка прошла успешно.
`CANCELLED`	Пользователь отменил установку до подтверждения.

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

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

SELECT
  billing_setup.resource_name,
  billing_setup.id,
  billing_setup.status,
  billing_setup.payments_account,
  billing_setup.payments_account_info.payments_account_id,
  billing_setup.payments_account_info.payments_account_name,
  billing_setup.payments_account_info.payments_profile_id,
  billing_setup.payments_account_info.payments_profile_name,
  billing_setup.start_date_time,
  billing_setup.end_date_time,
  billing_setup.end_time_type
FROM billing_setup

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

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

Настройки BillingSetup которые еще не вступили в силу, можно отменить, отправив BillingSetupOperation с полем remove , установленным на имя ресурса настроек выставления счетов ( customers/{customer_id}/billingSetups/{billing_setup_id} ). Настройки выставления счетов можно отменить только в том случае, если их status — PENDING ожидание) или если они APPROVED для запуска в будущем.

Обзор платежей

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