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:
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ą rozliczeń. Ta nazwa jest drukowana na fakturach miesięcznych.payments_account_info.payments_profile_id
: 12-cyfrowy identyfikator używany do identyfikowania profilu płatności powiązanego z konfiguracją płatności.
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 status
są PENDING
lub gdy są APPROVED
i mają się rozpocząć w przyszłości.