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 Centrum płatności jest powiązane z profilem płatności, który ostatecznie odpowiada za obciążenia.
Konfiguracje płatności zawierają pole payments_account 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 z łącznikami (np."1234-5678-9012-3456") 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 w formacie ciągu z łą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ć się z istniejącym kontem płatności, ustaw wartość
payments_account na nazwę zasobu prawidłowego konta płatności (np.customers/{customer_id}/paymentsAccounts/{payments_account_id}). Nie modyfikuj jednak wartości payments_account_info.
Aby wyświetlić listę dostępnych kont Centrum płatności, użyj metody PaymentsAccountService.ListPaymentsAccounts.
Obiekty PaymentsAccount zależą od konta menedżera, którego używasz do uwierzytelniania.
W przypadku każdego PaymentsAccount nazwa zasobu rozliczeniowego konta menedżera znajduje się w polu paying_manager_customer.
Korzystanie z 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 już wspomnieliśmy, spowoduje to też 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 za pomocą profilu płatności, do którego się odwołuje.
Stan konfiguracji płatności
Nowe instancje BillingSetup podlegają zatwierdzeniu przed wejściem w życie. 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 |
Zatwierdzono, ale odpowiedni 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 GoogleAdsService.Search lub GoogleAdsService.SearchStream za pomocą zapytania w języku zapytań Google Ads (GAQL), które określa, które 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
Po uzyskaniu odwołania do BillingSetup możesz go użyć do utworzenia AccountBudgetProposal zgodnie z opisem w sekcji Budżety konta.
Anulowanie oczekującej konfiguracji płatności
BillingSetup, która nie weszła jeszcze 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 pole status ma wartość PENDING lub gdy mają one APPROVED rozpocząć się w przyszłości.