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ż ustawieniami faktury), które określa, kto jest obciążany kosztami poniesionymi w ramach budżetów konta konfiguracji płatności. Każde konto płatności odpowiada jednej fakturze.

Konta płatności

Każdy BillingSetup identyfikuje konto płatności, na które wystawiana jest faktura za koszty poniesione w ramach budżetów konta. To konto Płatności jest powiązane z profilem płatności, który ostatecznie ponosi odpowiedzialność za opłaty.

Konfiguracje płatności zawierają zarówno pole payments_account, jak i grupę pól payments_account_info identyfikujących używane konto płatności, w tym:

Jeśli konto płatności kwalifikuje się do płatności skonsolidowanych, można zgrupować na jednej fakturze kilka kont Google Ads, ustawiając na nich konfiguracje płatności, które będą korzystać z tego samego konta płatności.

Tworzenie nowych konfiguracji płatności

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

Używanie istniejącego konta Google Payments

Aby połączyć się z istniejącym kontem płatności, ustaw wartość payments_account na identyfikator zasobu prawidłowego konta płatności. Nie należy jednak modyfikować payments_account_info.

Aby wyświetlić listę dostępnych kont płatności, użyj metody PaymentsAccountService.ListPaymentsAccounts. Zwracane wartości zależą od konta menedżera używanego do uwierzytelniania.PaymentsAccounts

W przypadku każdego PaymentsAccount identyfikator jego płatniczego menedżera znajduje się w polu paying_manager_customer.

Używanie nowego konta Centrum płatności

Aby połączyć się z nowym kontem płatności, ustaw w polach poniższe wartości:payments_account_info (nie ustawiaj pola 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ż wspomnieliśmy, spowoduje to też 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 usłudze płatności przy użyciu wskazanego profilu płatności.

Stan konfiguracji płatności

Nowe instancje BillingSetup wymagają zatwierdzenia, zanim zaczną obowiązywać. Do tego czasu ich status jest w stanie PENDING.

BillingSetup może mieć jeden z tych stanów:status

Stan konfiguracji płatności Opis
PENDING Czeka na zatwierdzenie.
APPROVED_HELD Zatwierdzony, ale odpowiadający mu pierwszy budżet nie został zatwierdzony. Może się to zdarzyć tylko w przypadku konfiguracji płatności skonfigurowanych pod kątem fakturowania miesięcznego.
APPROVED Konfiguracja została zatwierdzona.
CANCELLED Użytkownik anulował konfigurację przed zatwierdzeniem.

Pobieranie konfiguracji płatności na koncie

Podobnie jak większość innych obiektów w interfejsie Google Ads API, obiekt BillingSetup jest pobierany przez wysłanie zapytania do usługi GoogleAdsService.SearchStream za pomocą języka zapytań Google Ads, które określa, które pola mają zostać zwrócone.

Po uzyskaniu odwołania 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

BillingSetup, które jeszcze nie weszło w życie, można anulować za pomocą operacji usuwania. Konfiguracje płatności można anulować tylko wtedy, gdy ich statusPENDING lub gdy są APPROVED i mają się rozpocząć w przyszłości.