Konfiguracja płatności to połączenie na poziomie konta między kontem Google Ads a kontem płatności (znane też jako konfiguracja faktury). Określa ono, kto jest obciążany kosztami ponoszonymi z powodu budżetów konta konfiguracji płatności. Każde konto płatności odpowiada jednej fakturze.
Konta płatności
Każdy element BillingSetup
określa konto płatności, na którym są wystawiane faktury za koszty poniesione w ramach budżetów konta. To konto płatności jest powiązane z profilem płatności, który jest ostatecznie odpowiedzialny za opłacanie opłat.
Konfiguracje płatności zawierają zarówno pole payments_account
, jak i grupę pól payments_account_info
, które identyfikują konto płatności, między innymi:
payments_account_info.payments_account_id
: 16-cyfrowy identyfikator używany 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 płatności kwalifikuje się do płatności skonsolidowanych, możesz zgrupować kilka kont Google Ads w ramach tej samej faktury, ustawiając ich konfiguracje płatności tak, aby korzystały z tego samego konta płatności.
Tworzenie nowych konfiguracji płatności
Nowe konfiguracje płatności możesz łączyć z dotychczasowymi kontami płatności lub z kontami utworzonymi jednocześnie.
Korzystanie z istniejącego konta płatności
Aby połączyć konto z istniejącym kontem płatności, ustaw payments_account
na identyfikator zasobu prawidłowego konta płatności. Nie modyfikuj jednak payments_account_info
.
Możesz wyświetlić listę dostępnych kont płatności za pomocą metody PaymentsAccountService.ListPaymentsAccounts
. Zwrócone wartości PaymentsAccounts
zależą od konta menedżera używanego do uwierzytelniania.
W przypadku każdego elementu PaymentsAccount
w polu paying_manager_customer
podany jest identyfikator konta menedżera dokonującego płatności.
Używanie nowego konta płatności
Aby połączyć nowe konto 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ż podano powyżej, spowoduje to również 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 na potrzeby rozliczeń za pomocą podanego profilu płatności.
Stan konfiguracji płatności
Nowe instancje BillingSetup
muszą zostać zatwierdzone, zanim zaczną obowiązywać. Do tego czasu status
jest w stanie PENDING
.
Element BillingSetup
może znajdować się w jednym z tych elementów status
:
Stan konfiguracji płatności | Opis |
---|---|
PENDING |
Czeka na zatwierdzenie. |
APPROVED_HELD |
Zatwierdzono, ale odpowiadający mu pierwszy budżet nie. Może się tak 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 w przypadku większości innych elementów w interfejsie Google Ads API, obiekt BillingSetup
jest pobierany przez wysłanie zapytania do GoogleAdsService.SearchStream
przy użyciu zapytania Google Ads w języku zapytań określającego pola do zwrócenia.
Po uzyskaniu odniesienia 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
Element BillingSetup
, który nie działa jeszcze, można anulować za pomocą operacji usuwania. Konfiguracje płatności można anulować tylko wtedy, gdy ich status
to PENDING
lub jeśli APPROVED
ma się rozpocząć w przyszłości.