Ustawienia 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, komu są naliczane koszty poniesione przez budżety tego zestawu ustawień płatności. Każde konto płatności odpowiada jednej fakturze.
Konta płatności
Każdy identyfikator BillingSetup
wskazuje konto płatności, które otrzymuje faktury za koszty poniesione przez budżety tego 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
oraz grupę pól payments_account_info
, które wskazują używane konto systemu płatności, m.in.:
payments_account_info.payments_account_id
: 16-cyfrowy identyfikator służący do identyfikacji 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. Ta nazwa jest drukowana na fakturach miesięcznych.payments_account_info.payments_profile_id
: 12-cyfrowy identyfikator służący do identyfikacji profilu płatności powiązanego z konfiguracją płatności.
Jeśli konto Google Payments kwalifikuje się do płatności skonsolidowanych, możesz zgrupować wiele kont Google Ads na jednej fakturze, ustawiając ich konfiguracje płatności tak, aby korzystały z tego samego konta Google Payments.
Tworzenie nowych konfiguracji płatności
Nowe konfiguracje płatności możesz łączyć z dotychczasowymi kontami płatności lub z tymi, które zostaną utworzone w tym samym czasie.
Korzystanie z dotychczasowego konta płatności
Aby połączyć konto z dotychczasowym kontem płatności, ustawpayments_account
na identyfikator zasobu prawidłowego konta płatności. Nie modyfikuj jednak pliku payments_account_info
.
Aby wyświetlić listę dostępnych kont płatności, użyj metody PaymentsAccountService.ListPaymentsAccounts
. Zwrócony parametr PaymentsAccounts
zależy od konta menedżera, którego używasz do uwierzytelniania.
W przypadku każdego PaymentsAccount
identyfikator płatnika jest podany w polu paying_manager_customer
.
Korzystanie z nowego konta płatności
Aby połączyć konto z nowym kontem płatności, skonfiguruj te pola w payments_account_info
(nie konfiguruj pola payments_account
):
Przykład poniżej pokazuje, jak utworzyć nową konfigurację płatności na podstawie dotychczasowego identyfikatora profilu płatności. Jak wspomniano wyżej, 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 dodana do konta Google Ads, spowoduje to zarejestrowanie klienta w usługach płatności za pomocą wskazanego profilu płatności.
Stan konfiguracji płatności
Nowe instancje BillingSetup
muszą zostać zatwierdzone, zanim zaczną obowiązywać. Do tego czasu status
będzie 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 |
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, element BillingSetup
jest pobierany przez wysłanie zapytania do elementu GoogleAdsService.SearchStream
za pomocą zapytania w języku zapytań Google Ads, które określa, które pola mają zostać zwrócone.
Po uzyskaniu odwołania do BillingSetup
możesz użyć tego odwołania do utworzenia AccountBudgetProposal
w sposób opisany w artykule Budżet konta.
Anulowanie oczekującej konfiguracji płatności
Operację BillingSetup
, która nie została jeszcze zastosowana, można anulować za pomocą operacji usuwania. Konfiguracje płatności można anulować tylko wtedy, gdy status
sąPENDING
APPROVED
status
lub mają się rozpocząć w przyszłości.