Konfiguracja płatności

Konfiguracja płatności to połączenie na poziomie konta między kontem Google Ads a kontem płatności (znanym też jako konfiguracja faktury), które skutecznie określa, kto jest obciążany kosztami poniesionymi w ramach budżetów konta w konfiguracji płatności. Każde konto płatności odpowiada jednej fakturze.

Informacje o kontach płatności

Każda BillingSetup identyfikuje konto płatności , na które wystawiana jest 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:

Jeśli konto płatności kwalifikuje się do płatności skonsolidowanych, można pogrupować kilka kont Google Ads na tej samej fakturze, ustawiając ich konfiguracje płatności tak, aby korzystały z tego samego bazowego konta płatności.

Tworzenie nowych konfiguracji płatności

Nowe konfiguracje płatności możesz połączyć z istniejącymi 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 payments_account na identyfikator zasobu prawidłowego konta płatności. Nie modyfikuj jednak don't payments_account_info.

Listę dostępnych kont płatności możesz wyświetlić za pomocą metody PaymentsAccountService.ListPaymentsAccounts. Zwracane konta płatności (PaymentsAccounts) zależą 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 paying_manager_customer polu.

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 wspomnieliśmy wcześniej, spowoduje to też 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 usłudze płatności przy użyciu wskazanego profilu płatności.

Stan konfiguracji płatności

Zanim nowe instancje BillingSetup zaczną obowiązywać, muszą zostać zatwierdzone. Do tego czasu ich status jest w PENDING stanie.

BillingSetup może mieć jeden z tych status:

Stan konfiguracji płatności Opis
PENDING Czeka na zatwierdzenie.
APPROVED_HELD Zatwierdzona, ale nie zatwierdzono pierwszego powiązanego budżetu. Może się to zdarzyć tylko w przypadku konfiguracji płatności skonfigurowanych na fakturowanie miesięczne.
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 encji w interfejsie Google Ads API, a BillingSetup pobiera się, wysyłając zapytanie do GoogleAdsService.SearchStream za pomocą zapytania w języku zapytań Google Ads, które określa, które pola mają zostać zwrócone.

Gdy uzyskasz odniesienie do BillingSetup, możesz go użyć do utworzenia AccountBudgetProposal, jak opisano w Budżet konta.

Anulowanie konfiguracji płatności w stanie oczekiwania

BillingSetup, która jeszcze nie zaczęła obowiązywać, można anulować za pomocą operacji usuwania. Konfiguracje płatności można anulować tylko wtedy, gdy ich status to PENDING lub gdy są APPROVED i mają zacząć obowiązywać w przyszłości.

Wstecz
Omówienie rozliczeń
Dalej
Budżet konta