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` Stałe. 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)` Stałe. 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ć). Po utworzeniu konfiguracji płatności to pole oraz konto płatności zostaną wypełnione.
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator konfiguracji płatności.
`paymentsAccount`	`string` Stałe. 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 zarejestrowania się za pomocą istniejącego konta płatności (w którym nie należy ustawiać płatnościAccountInfo). Po uzyskaniu konfiguracji płatności wypełnione będą pola to oraz paymentsAccountInfo.
Pole sumy `start_time`. To moment, w którym powinna zostać zastosowana nowa konfiguracja płatności. TERAZ to jedyny dopuszczalny czas rozpoczęcia, jeśli klient nie ma żadnych zatwierdzonych konfiguracji. W przypadku pobierania istniejącej konfiguracji płatności jest to żądana godzina rozpoczęcia. Jeśli jednak konfiguracja została zatwierdzona (zobacz stan) po żądanej godzinie rozpoczęcia, jest to czas zatwierdzenia. `start_time` może być tylko jedną z tych wartości:
`startDateTime`	`string` Stałe. Data i godzina rozpoczęcia w formacie rrrr-MM-dd lub rrrr-MM-dd GG:mm:ss. Dozwolone jest tylko określenie godziny z przyszłości.
`startTimeType`	`enum (TimeType)` Stałe. Typ godziny rozpoczęcia. Dozwolone jest tylko NOW.
Pole sumy `end_time`. Zakończenie lub zakończenie konfiguracji płatności. Jest to czas TRWAŁY albo czas rozpoczęcia następnej zaplanowanej konfiguracji płatności. `end_time` może być 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. Godzina zakończenia jako typ. Jedyna możliwa wartość to ZAWSZE.

BillingSetupStatus

Możliwe stany konfiguracji płatności.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
`PENDING`	Konfiguracja płatności oczekuje na zatwierdzenie.
`APPROVED_HELD`	Konfiguracja płatności została zatwierdzona, ale powiązany z nią pierwszy budżet jeszcze nie. Może się tak zdarzyć 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 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 identyfikacji konta płatności powiązanego z konfiguracją płatności. Należy je przekazać jako ciąg z myślnikami, np. „1234-5678-9012-3456”.
`paymentsAccountName`	`string` Stałe. Nazwa konta płatności powiązanego z konfiguracją płatności. Dzięki temu użytkownik może podać rozpoznawalną nazwę konta płatności, która pomoże mu w uzgadnianiu faktur miesięcznych. Ta nazwa będzie widoczna na fakturach miesięcznych.
`paymentsProfileId`	`string` Stałe. 12-cyfrowy identyfikator służący do identyfikacji profilu płatności powiązanego z konfiguracją płatności. Należy ją przekazać jako ciąg 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, który występuje w rzadkich sytuacjach, na przykład gdy zawarto umowę dotyczącą odpowiedzialności sekwencyjnej.