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.
Informacje o kontach 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 identyfikują używane konto systemu płatności, w tym:
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żna połączyć kilka 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 istniejącym 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. Zwracana wartośćPaymentsAccounts zależy od konta menedżera używanego 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 już 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łudze płatności za pomocą odnośnika do 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 ich konto status ma wartość PENDING lub jeśli APPROVED ma się rozpoczynać w przyszłości.