Konfiguracja płatności

Konfiguracja płatności to połączenie na poziomie konta między kontem Google Ads a kontem płatności (znane też jako konfiguracja faktury). Określa ono, kto jest obciążany kosztami ponoszonymi z powodu budżetów 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 za 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łacanie opłat.

Konfiguracje płatności zawierają zarówno pole payments_account, jak i grupę pól payments_account_info, które identyfikują konto płatności, między innymi:

Jeśli konto płatności kwalifikuje się do płatności skonsolidowanych, możesz zgrupować kilka kont Google Ads w ramach tej samej faktury, ustawiając ich konfiguracje 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ć konto z istniejącym kontem płatności, ustaw payments_account na identyfikator zasobu prawidłowego konta płatności. Nie modyfikuj jednak payments_account_info.

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

W przypadku każdego elementu PaymentsAccount w polu paying_manager_customer podany jest identyfikator konta menedżera dokonującego płatności.

Używanie nowego konta płatności

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

Poniższy przykład pokazuje, jak utworzyć nową konfigurację płatności na podstawie istniejącego identyfikatora profilu płatności. Jak już podano 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 na potrzeby rozliczeń za pomocą podanego 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.

Element 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 odpowiadający mu 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 w przypadku większości innych elementów w interfejsie Google Ads API, obiekt BillingSetup jest pobierany przez wysłanie zapytania do GoogleAdsService.SearchStream przy użyciu zapytania Google Ads w języku zapytań określającego 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

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