Konfiguracja płatności to połączenie na poziomie konta między kontem Google Ads a kontem płatności (nazywane też ustawieniami faktury), które określa, kto jest obciążany kosztami poniesionymi w ramach budżetów konta objętych tą konfiguracją. Każde konto płatności odpowiada jednej fakturze.
Konta płatności
Każdy BillingSetup identyfikuje konto płatności, na które jest wystawiana 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 odpowiada za opłaty.
Konfiguracje płatności zawierają zarówno pole payments_account, jak i grupę pól payments_account_info, które identyfikują używane konto płatności, w tym:
payments_account_info.payments_account_id: 16-cyfrowy identyfikator w formacie ciągu znaków rozdzielonych łącznikami (np."1234-5678-9012-3456") 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 w postaci ciągu znaków rozdzielonych łącznikami (np."1234-5678-9012") 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 na tej samej fakturze, 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 połą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 nazwę zasobu prawidłowego konta płatności (np. customers/{customer_id}/paymentsAccounts/{payments_account_id}). Nie modyfikuj jednak payments_account_info.
Aby wyświetlić listę dostępnych kont płatności, użyj metody PaymentsAccountService.ListPaymentsAccounts.
Zwracane obiekty PaymentsAccount zależą od konta menedżera, którego używasz do uwierzytelniania.
W przypadku każdego zasobu PaymentsAccount nazwa zasobu menedżera dokonującego płatności znajduje się w polu paying_manager_customer.
Używanie nowego konta 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 wspomnieliśmy wcześniej, spowoduje to również utworzenie nowego konta płatności o nazwie My New Payments Account.
BillingSetup billingSetup =
BillingSetup.newBuilder()
.setPaymentsAccountInfo(
PaymentsAccountInfo.newBuilder()
.setPaymentsAccountName("My New Payments Account")
.setPaymentsProfileId("1234-5678-9012")
.build())
.setStartTimeType(TimeTypeEnum.TimeType.NOW)
.build();
BillingSetupOperation operation =
BillingSetupOperation.newBuilder().setCreate(billingSetup).build();
try (BillingSetupServiceClient billingSetupServiceClient =
googleAdsClient.getBillingSetupServiceClient()) {
MutateBillingSetupResponse response =
billingSetupServiceClient.mutateBillingSetup(
Long.toString(customerId), operation);
}
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 muszą zostać zatwierdzone, zanim zaczną obowiązywać. Do tego czasu ich status jest w stanie PENDING.
BillingSetup może mieć jedną z tych wartości status:
BillingSetupStatus |
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, BillingSetup jest pobierany przez wysłanie zapytania do GoogleAdsService.Search lub GoogleAdsService.SearchStream za pomocą zapytania w języku Google Ads Query Language (GAQL), które określa, jakie pola mają zostać zwrócone:
SELECT
billing_setup.resource_name,
billing_setup.id,
billing_setup.status,
billing_setup.payments_account,
billing_setup.payments_account_info.payments_account_id,
billing_setup.payments_account_info.payments_account_name,
billing_setup.payments_account_info.payments_profile_id,
billing_setup.payments_account_info.payments_profile_name,
billing_setup.start_date_time,
billing_setup.end_date_time,
billing_setup.end_time_type
FROM billing_setup
Gdy uzyskasz odwołanie do BillingSetup, możesz go użyć do utworzenia AccountBudgetProposal zgodnie z opisem w artykule Budżety konta.
Anulowanie oczekującej konfiguracji płatności
BillingSetup, które jeszcze nie weszło w życie, można anulować, wysyłając BillingSetupOperation z polem remove ustawionym na nazwę zasobu konfiguracji płatności (customers/{customer_id}/billingSetups/{billing_setup_id}). Konfiguracje płatności można anulować tylko wtedy, gdy ich status to PENDING lub gdy są APPROVED, aby rozpocząć się w przyszłości.