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 PaymentsAccountszależą od konta menedżera używanego do uwierzytelniania.
W przypadku każdego PaymentsAccount identyfikator płacącego 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 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ż 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.