Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.

Ta strona została przetłumaczona przez Cloud Translation API.

BillingSetup

Zapis JSON
BillingSetupStatus
PaymentsAccountInfo
- Zapis JSON

Konfiguracja płatności, która łączy konto płatności z reklamodawcą. Konfiguracja płatności jest przypisana do jednego reklamodawcy.

Zapis JSON

Zapis JSON
{ "resourceName": string, "status": enum (`BillingSetupStatus`), "paymentsAccountInfo": { object (`PaymentsAccountInfo`) }, "id": string, "paymentsAccount": string, // Union field `start_time` can be only one of the following: "startDateTime": string, "startTimeType": enum (`TimeType`) // End of list of possible types for union field `start_time`. // Union field `end_time` can be only one of the following: "endDateTime": string, "endTimeType": enum (`TimeType`) // End of list of possible types for union field `end_time`. }

{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}

Pola
`resourceName`	`string` Niezmienna. Nazwa zasobu konfiguracji płatności. Nazwy zasobów konfiguracji płatności mają następujący format: `customers/{customerId}/billingSetups/{billing_setup_id}`
`status`	`enum (BillingSetupStatus)` Tylko dane wyjściowe. Stan konfiguracji płatności.
`paymentsAccountInfo`	`object (PaymentsAccountInfo)` Stały. Dane konta płatności powiązanego z tą konfiguracją płatności. Podczas konfigurowania płatności służy do rejestracji nowego konta płatności (w tym przypadku nie należy ustawiać parametru paymentsAccount). Podczas konfigurowania płatności te pola i pole paymentsAccount zostaną wypełnione.
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator konfiguracji płatności.
`paymentsAccount`	`string` Stały. Nazwa zasobu konta płatności powiązanego z tą konfiguracją płatności. Nazwy zasobów płatności mają postać: `customers/{customerId}/paymentsAccounts/{paymentsAccountId}` Podczas konfigurowania płatności służy do rejestracji na istniejącym koncie płatności (w tym przypadku nie należy ustawiać wartości paymentsAccountInfo). Podczas konfiguracji płatności zostaną wypełnione te dane oraz paymentsAccountInfo.
Pole unii `start_time`. Gdy tworzysz nową konfigurację płatności, określa ona, kiedy ma ona zacząć obowiązywać. Jeśli klient nie ma zatwierdzonych konfiguracji, jedynym akceptowalnym czasem rozpoczęcia jest TERAZ. Podczas pobierania istniejącej konfiguracji płatności jest to żądany czas rozpoczęcia. Jeśli jednak konfiguracja została zatwierdzona (patrz stan) po żądanej godzinie rozpoczęcia, to właśnie ten czas jest uznawany za czas zatwierdzenia. `start_time` może być tylko jednym z tych elementów:
`startDateTime`	`string` Niezmienna. Data i godzina rozpoczęcia w formacie rrrr-MM-dd lub rrrr-MM-dd HH:mm:ss. Dozwolone są tylko daty z przyszłości.
`startTimeType`	`enum (TimeType)` Stały. Typ czasu rozpoczęcia. Dozwolone jest tylko NOW.
Pole sumy `end_time`. Kiedy kończy się/zakończyła się konfiguracja płatności. Możesz wybrać opcję „FOREVER” (ZAWSZE) lub podać czas rozpoczęcia następnej zaplanowanej konfiguracji płatności. `end_time` może być tylko jednym z tych elementów:
`endDateTime`	`string` Tylko dane wyjściowe. Data i godzina zakończenia w formacie rrrr-MM-dd lub rrrr-MM-dd GG:mm:ss.
`endTimeType`	`enum (TimeType)` Tylko dane wyjściowe. Typ czasu zakończenia. Jedyną możliwą wartością jest FOREVER.

BillingSetupStatus

Możliwe stany BillingSetup.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
`PENDING`	Konfiguracja płatności oczekuje na zatwierdzenie.
`APPROVED_HELD`	Konfiguracja płatności została zatwierdzona, ale odpowiadający jej pierwszy budżet nie. Może się to zdarzyć tylko w przypadku konfiguracji płatności skonfigurowanych pod kątem fakturowania miesięcznego.
`APPROVED`	Konfiguracja płatności została zatwierdzona.
`CANCELLED`	Użytkownik anulował konfigurację płatności przed jej zatwierdzeniem.

PaymentsAccountInfo

Kontener informacji o koncie płatności dla tego rozliczenia.

Zapis JSON
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string }

Pola
`paymentsAccountId`	`string` Tylko dane wyjściowe. 16-cyfrowy identyfikator służący do identyfikowania konta płatności powiązanego z konfiguracją płatności. Musisz podać go jako ciąg znaków z myślnikami, np. „1234-5678-9012-3456”.
`paymentsAccountName`	`string` Niezmienna. Nazwa konta płatności powiązanego z konfiguracją płatności. Dzięki temu użytkownik może podać nazwę konta płatności, która ułatwia uzgadnianie faktur miesięcznych. Ta nazwa będzie drukowana na fakturach miesięcznych.
`paymentsProfileId`	`string` Niezmienna. 12-cyfrowy identyfikator służący do identyfikowania profilu płatności powiązanego z konfiguracją płatności. Należy go przekazać w postaci ciągu z myślnikami, np. „1234-5678-9012”.
`paymentsProfileName`	`string` Tylko dane wyjściowe. Nazwa profilu płatności powiązanego z konfiguracją płatności.
`secondaryPaymentsProfileId`	`string` Tylko dane wyjściowe. Identyfikator dodatkowego profilu płatności występuje w nietypowych sytuacjach, np. gdy została zawarta umowa o odpowiedzialności sekwencyjnej.