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 wiąże 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` Niezmienne. Nazwa zasobu konfiguracji płatności. Nazwy zasobów konfiguracji rozliczeń mają postać: `customers/{customerId}/billingSetups/{billing_setup_id}`
`status`	`enum (BillingSetupStatus)` Tylko dane wyjściowe. Stan konfiguracji płatności.
`paymentsAccountInfo`	`object (PaymentsAccountInfo)` Niezmienne. Informacje o koncie płatności powiązane z tą konfiguracją płatności. Służy on do rejestracji nowego konta płatności (i nie należy go wtedy konfigurować). Podczas tworzenia konfiguracji płatności to pole i konto_płatności będą wypełnione.
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator konfiguracji płatności.
`paymentsAccount`	`string` Niezmienne. 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 parametr ten służy do rejestracji za pomocą istniejącego konta płatności (nie należy wtedy ustawiać paymentsAccountInfo). Podczas tworzenia konfiguracji płatności pole to oraz paymentsAccountInfo będą wypełniane.
Pole sumy `start_time`. To właśnie czas tworzenia nowej konfiguracji płatności zaczyna obowiązywać. Jeśli klient nie ma żadnych zatwierdzonych konfiguracji, jest to jedyny dopuszczalny czas rozpoczęcia. Podczas pobierania istniejącej konfiguracji płatności jest to żądany czas rozpoczęcia. Jeśli jednak konfiguracja została zatwierdzona (sprawdź stan) po żądanym czasie rozpoczęcia, jest to czas zatwierdzenia. `start_time` może mieć tylko jedną z tych wartości:
`startDateTime`	`string` Niezmienne. Data i godzina rozpoczęcia w formacie rrrr-MM-dd lub rrrr-MM-dd GG:mm:ss. Dozwolona jest tylko godzina w przyszłości.
`startTimeType`	`enum (TimeType)` Niezmienne. Typ godziny rozpoczęcia. Dozwolona jest tylko wartość NOW.
Pole sumy `end_time`. Zakończenie lub zakończenie konfiguracji płatności. Jest to czas TRWAŁY lub godzina rozpoczęcia następnej zaplanowanej konfiguracji płatności. `end_time` może mieć tylko jedną z tych wartości:
`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 godziny zakończenia. Jedyna możliwa wartość to ZAWSZE.

BillingSetupStatus

Możliwe stany konfiguracji płatności.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`PENDING`	Konfiguracja płatności oczekuje na zatwierdzenie.
`APPROVED_HELD`	Konfiguracja płatności została zatwierdzona, ale nie odpowiada jej pierwszy budżet. Dzieje się tak tylko w przypadku konfiguracji płatności skonfigurowanych pod kątem fakturowania miesięcznego.
`APPROVED`	Konfiguracja płatności została zatwierdzona.
`CANCELLED`	Konfiguracja płatności została anulowana przez użytkownika przed jej zatwierdzeniem.

PaymentsAccountInfo

Kontener informacji o koncie płatności na potrzeby tej płatności.

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

Pola
`paymentsAccountId`	`string` Tylko dane wyjściowe. 16-cyfrowy identyfikator używany do identyfikowania konta płatności powiązanego z konfiguracją płatności. Należy go przekazać jako ciąg z myślnikami, np. „1234-5678-9012-3456”.
`paymentsAccountName`	`string` Niezmienne. Nazwa konta płatności powiązanego z konfiguracją płatności. Dzięki temu użytkownik może określić rozpoznawalną nazwę konta płatności, aby ułatwić uzgadnianie faktur miesięcznych. Ta nazwa będzie widoczna na fakturach miesięcznych.
`paymentsProfileId`	`string` Niezmienne. 12-cyfrowy identyfikator służący do identyfikacji profilu płatności powiązanego z konfiguracją płatności. Należy go przekazać jako ciąg znaków 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ępującego w rzadkich sytuacjach, na przykład gdy zawarto umowę dotyczącą odpowiedzialności sekwencyjnej.