Konfiguracja płatności to połączenie na poziomie konta między kontem Google Ads a kontem płatności (nazywanym też konfiguracją faktury). Pozwala to ustalić, kto jest obciążany kosztami poniesionymi przez budżety konta skonfigurowane w konfiguracji 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 jest fakturowane za koszty naliczone w ramach budżetów kont. To konto płatności jest powiązane z profilem płatności, który jest ostatecznie odpowiedzialny za obciążenia.
Konfiguracje płatności zawierają zarówno pole payments_account
, jak i grupę pól payments_account_info
, które wskazują, że konto płatności jest używane. Należą do nich m.in.:
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ą płatności. Nazwa ta jest wydrukowana na fakturach miesięcznych.payments_account_info.payments_profile_id
: 12-cyfrowy identyfikator służący do rozpoznawania profilu płatności powiązanego z konfiguracją płatności.
Jeśli konto płatności kwalifikuje się do korzystania z płatności skonsolidowanych, możesz zgrupować wiele kont Google Ads na jednej fakturze. Aby to zrobić, skonfiguruj ich ustawienia 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 w tym samym czasie.
Korzystanie z istniejącego konta płatności
Aby połączyć z istniejącym kontem płatności, ustaw payments_account
na identyfikator zasobu prawidłowego konta płatności. Nie modyfikuj payments_account_info
.
Możesz wymienić dostępne konta płatności za pomocą metody PaymentsAccountService.ListPaymentsAccounts
. Zwracana wartość PaymentsAccounts
zależy od konta menedżera używanego do uwierzytelniania.
W przypadku każdego PaymentsAccount
identyfikator konta menedżera dokonującego płatności znajduje się w polu paying_manager_customer
.
Korzystanie z nowego konta płatności
Aby połączyć z nowym kontem płatności, ustaw w payments_account_info
te pola (nie ustawiaj payments_account
):
Przykład poniżej pokazuje, jak utworzyć nową konfigurację płatności na podstawie istniejącego identyfikatora profilu płatności. Jak wspomnieliśmy 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 w celach rozliczeniowych przy użyciu wskazanego profilu płatności.
Stan konfiguracji płatności
Nowe instancje BillingSetup
muszą zostać zatwierdzone, zanim zaczną obowiązywać. Do tego czasu jego status
znajduje się w stanie PENDING
.
BillingSetup
może być 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. Jest to możliwe tylko w przypadku konfiguracji płatności skonfigurowanych do fakturowania miesięcznego. |
APPROVED |
Konfiguracja została zatwierdzona. |
CANCELLED |
Konfiguracja została anulowana przez użytkownika przed zatwierdzeniem. |
Pobieram konfigurację płatności na koncie
Podobnie jak większość innych elementów w interfejsie Google Ads API, BillingSetup
jest pobierany przez zapytanie GoogleAdsService.SearchStream
za pomocą zapytania Google Ads Query Language, które określa, które pola zwrócić.
Gdy uzyskasz odniesienie do obiektu 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 został jeszcze zastosowany, 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.