Konfiguracja płatności

Konfiguracja płatności to połączenie na poziomie konta między kontem Google Ads a kontem płatności (nazywane też konfiguracją faktury). Określa ono, kto jest obciążany kosztami ponoszonymi przez budżety konta konfiguracji płatności. Każde konto płatności odpowiada jednej fakturze.

Konta płatności

Każdy element BillingSetup określa konto płatności, na którym są wystawiane faktury obejmujące koszty poniesione w ramach budżetów konta. To konto płatności jest powiązane z profilem płatności, który jest ostatecznie odpowiedzialny za opłaty.

Konfiguracje płatności zawierają pole payments_account i grupę pól payments_account_info identyfikujących używane konto płatności. Są to między innymi:

Jeśli dane konto płatności kwalifikuje się do korzystania z płatności skonsolidowanych, możesz zgrupować wiele kont Google Ads na jednej fakturze. W tym celu konfiguruj ustawienia płatności 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 jednocześnie.

Korzystanie z istniejącego konta płatności

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

Możesz wyświetlić listę dostępnych kont płatności, używając metody PaymentsAccountService.ListPaymentsAccounts. Zwrócone wartości PaymentsAccounts zależą od konta menedżera używanego do uwierzytelniania.

Przy każdym elemencie PaymentsAccount identyfikator menedżera dokonującego płatności znajduje się w polu paying_manager_customer.

Korzystanie z nowego konta płatności

Aby połączyć nowe konto płatności, ustaw te pola w payments_account_info (nie ustawiaj wartości payments_account):

Poniższy przykład pokazuje, jak utworzyć nową konfigurację płatności na podstawie istniejącego identyfikatora profilu płatności. Jak wspomniano 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 dodana do konta Google Ads, spowoduje to zarejestrowanie klienta w płatnościach za pomocą wymienionego profilu płatności.

Stan konfiguracji płatności

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

BillingSetup może znajdować się w jednym z tych elementów status:

Stan konfiguracji płatności Opis
PENDING Czeka na zatwierdzenie.
APPROVED_HELD Zatwierdzono, ale powiązany z nim pierwszy budżet nie. Może się tak zdarzyć tylko w przypadku konfiguracji płatności skonfigurowanych pod kątem fakturowania miesięcznego.
APPROVED Konfiguracja została zatwierdzona.
CANCELLED Konfiguracja została anulowana przez użytkownika przed zatwierdzeniem.

Pobieranie konfiguracji płatności na koncie

Podobnie jak większość innych elementów w interfejsie Google Ads API, obiekt BillingSetup jest pobierany przez wysłanie zapytania na element GoogleAdsService.SearchStream przy użyciu zapytania Google Ads Query Language, które określa pola do zwrócenia.

Po uzyskaniu odniesienia do BillingSetup możesz go użyć do utworzenia AccountBudgetProposal zgodnie z opisem w sekcji Budżet konta.

Anulowanie oczekującej konfiguracji płatności

Pole BillingSetup, które nie zostało jeszcze zastosowane, można anulować, używając operacji usuwania. Konfiguracje płatności można anulować tylko wtedy, gdy ich status mają wartość PENDING lub jeśli: APPROVED mają się zacząć w przyszłości.

Wstecz
Przegląd
Dalej
Budżet konta