Konfiguracja płatności to połączenie na poziomie konta między kontem Google Ads a Centrum płatności konta (zwanego też fakturą konfiguracji). określa, kto jest obciążany kosztami poniesionymi przez konto konfiguracji płatności budżetów. Każde konto płatności odpowiada jednej fakturze.
Informacje o kontach płatności
Każdy identyfikator BillingSetup
określa konto płatności.
jest fakturowana na koszty ponoszone w ramach budżetów kont. Ta płatność
to konto jest powiązane z płatnościami
który jest ostatecznie nazywany
odpowiedzialnym za opłaty.
Konfiguracje płatności zawierają zarówno payments_account
i grupę
payments_account_info
.
pola określające, które konto płatności jest używane, 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 drukowany na fakturach miesięcznych.payments_account_info.payments_profile_id
: 12-cyfrowy identyfikator używany do identyfikacji profilu płatności powiązanego z konfigurację płatności.
Jeśli konto płatności kwalifikuje się do konsolidacji płatności, a potem wiele usług Google Konta Google Ads można grupować na tej samej fakturze według ustawień płatności. korzystać z tego samego bazowego konta płatności.
Tworzenie nowych konfiguracji płatności
Możesz łączyć nowe konfiguracje płatności z istniejącymi lub utworzonymi kontami płatności z powrotem.
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 jednak
payments_account_info
.
Możesz wymienić dostępne konta płatności za pomocą
PaymentsAccountService.ListPaymentsAccounts
.
Zwracane dane (PaymentsAccounts
) zależą od konta menedżera, którego używasz
uwierzytelnianie.
W przypadku każdego pola PaymentsAccount
identyfikator jego płatności
menedżera jest w
paying_manager_customer
.
Korzystanie z nowego konta płatności
Aby połączyć z nowym kontem płatności, ustaw następujące pola w
payments_account_info
(nie ustawiaj payments_account
):
Przykład poniżej pokazuje, jak utworzyć nową konfigurację płatności na podstawie dotychczasowej
Identyfikator profilu płatności. Jak wspomnieliśmy powyżej, spowoduje to też utworzenie nowego
Konto 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, zarejestrować klienta w celach rozliczeniowych przy użyciu wskazanej formy płatności. profil.
Stan konfiguracji płatności
Nowe instancje BillingSetup
podlegają
przed ich wejściem w życie. Do tego czasu ich
status
jest w
PENDING
stanu.
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. 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 interfejsu Google Ads API,
Pole BillingSetup
jest pobierane przez zapytanie
GoogleAdsService.SearchStream
za pomocą zapytania w języku Google Ads Query Language, które określa pola do zwrócenia.
Gdy uzyskasz odwołanie do BillingSetup
,
możesz go użyć do utworzenia
AccountBudgetProposal
, jak opisano w
Budżet konta.
Anulowanie oczekującej konfiguracji płatności
Element BillingSetup
, który nie został jeszcze zastosowany, może
można anulować za pomocą operacji usuwania. Konfiguracje płatności można anulować tylko wtedy, gdy
jego status
jest
PENDING
czy APPROVED
by zacząć wybiegać w przyszłość.