Konfiguracja płatności

Konfiguracja płatności to połączenie na poziomie konta między kontem Google Ads a kontem płatności (nazywanym też konfiguracją faktury). Pozwala to ustalić, kto jest obciążany kosztami poniesionymi przez budżety konta skonfigurowane w konfiguracji płatności. Każde konto płatności odpowiada jednej fakturze.

Informacje o kontach płatności

Każdy identyfikator BillingSetup wskazuje konto płatności, które jest fakturowane za koszty naliczone w ramach budżetów kont. To konto płatności jest powiązane z profilem płatności, który jest ostatecznie odpowiedzialny za obciążenia.

Konfiguracje płatności zawierają zarówno pole payments_account, jak i grupę pól payments_account_info, które wskazują, że konto płatności jest używane. Należą do nich m.in.:

• payments_account_info.payments_account_id: 16-cyfrowy identyfikator używany do identyfikowania konta płatności powiązanego z konfiguracją płatności.
• payments_account_info.payments_account_name: nazwa konta płatności powiązanego z konfiguracją płatności. Nazwa ta jest wydrukowana na fakturach miesięcznych.
• payments_account_info.payments_profile_id: 12-cyfrowy identyfikator służący do rozpoznawania profilu płatności powiązanego z konfiguracją płatności.

Jeśli konto płatności kwalifikuje się do korzystania z płatności skonsolidowanych, możesz zgrupować wiele kont Google Ads na jednej fakturze. Aby to zrobić, skonfiguruj ich ustawienia tak, aby korzystały z tego samego konta płatności.

Tworzenie nowych konfiguracji płatności

Nowe konfiguracje płatności możesz łączyć z dotychczasowymi kontami płatności lub z kontami utworzonymi w tym samym czasie.

Korzystanie z istniejącego konta płatności

Aby połączyć z istniejącym kontem płatności, ustaw payments_account na identyfikator zasobu prawidłowego konta płatności. Nie modyfikuj payments_account_info.

Możesz wymienić dostępne konta płatności za pomocą metody PaymentsAccountService.ListPaymentsAccounts. Zwracana wartość PaymentsAccounts zależy od konta menedżera używanego do uwierzytelniania.

W przypadku każdego PaymentsAccount identyfikator konta menedżera dokonującego płatności znajduje się w polu paying_manager_customer.

Korzystanie z nowego konta płatności

Aby połączyć z nowym kontem płatności, ustaw w payments_account_info te pola (nie ustawiaj payments_account):

• payments_account_name
• payments_profile_id

Przykład poniżej pokazuje, jak utworzyć nową konfigurację płatności na podstawie istniejącego identyfikatora profilu płatności. Jak wspomnieliśmy powyżej, spowoduje to również utworzenie nowego konta płatności o nazwie 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);
}

Jeśli jest to pierwsza konfiguracja płatności dodawana do konta Google Ads, spowoduje to zarejestrowanie klienta w celach rozliczeniowych przy użyciu wskazanego profilu płatności.

Stan konfiguracji płatności

Nowe instancje BillingSetup muszą zostać zatwierdzone, zanim zaczną obowiązywać. Do tego czasu jego status znajduje się w stanie PENDING.

BillingSetup może być w jednym z tych elementów status:

Stan konfiguracji płatności	Opis
PENDING	Czeka na zatwierdzenie.
APPROVED_HELD	Zatwierdzono, ale odpowiadający mu pierwszy budżet nie. Jest to możliwe tylko w przypadku konfiguracji płatności skonfigurowanych do fakturowania miesięcznego.
APPROVED	Konfiguracja została zatwierdzona.
CANCELLED	Konfiguracja została anulowana przez użytkownika przed zatwierdzeniem.

Pobieram konfigurację płatności na koncie

Podobnie jak większość innych elementów w interfejsie Google Ads API, BillingSetup jest pobierany przez zapytanie GoogleAdsService.SearchStream za pomocą zapytania Google Ads Query Language, które określa, które pola zwrócić.

Gdy uzyskasz odniesienie do obiektu BillingSetup, możesz go użyć do utworzenia AccountBudgetProposal zgodnie z opisem w sekcji Budżet konta.

Anulowanie oczekującej konfiguracji płatności

Element BillingSetup, który nie został jeszcze zastosowany, można anulować za pomocą operacji usuwania. Konfiguracje płatności można anulować tylko wtedy, gdy ich konto status ma wartość PENDING lub jeśli APPROVED ma się rozpoczynać w przyszłości.