UserListLicensePricing

Ceny licencji na listę użytkowników.

Zapis JSON
{
  "pricingId": string,
  "startTime": string,
  "endTime": string,
  "pricingActive": boolean,
  "buyerApprovalState": enum (UserListPricingBuyerApprovalState),
  "costMicros": string,
  "currencyCode": string,
  "costType": enum (UserListPricingCostType),
  "maxCostMicros": string
}
Pola
pricingId

string (int64 format)

Tylko dane wyjściowe. Identyfikator tego cennika.

startTime

string (Timestamp format)

Tylko dane wyjściowe. Czas rozpoczęcia obowiązywania ceny.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Opcjonalnie. Czas zakończenia obowiązywania ceny.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

pricingActive

boolean

Tylko dane wyjściowe. Określa, czy te ceny są aktywne.

buyerApprovalState

enum (UserListPricingBuyerApprovalState)

Tylko dane wyjściowe. Stan zatwierdzenia tych cen przez kupującego.

To pole jest tylko do odczytu.

costMicros

string (int64 format)

Opcjonalnie. Koszt związany z modelem, podany w mikrojednostkach (10^-6) w walucie określonej w polu currencyCode. Na przykład 2000000 oznacza 2 PLN, jeśli currencyCode to USD.

currencyCode

string

Opcjonalnie. Waluta, w której określono koszt i maksymalny koszt. Musi to być trzyliterowy kod waluty zdefiniowany w standardzie ISO 4217.

costType

enum (UserListPricingCostType)

Niezmienna. Typ kosztów tej ceny.

Można ustawić tylko w operacji create. Nie można go zaktualizować w przypadku istniejącej licencji.

maxCostMicros

string (int64 format)

Opcjonalnie. Maksymalny CPM, jaki może zostać naliczony w przypadku odbiorców z list partnerów handlowych, gdy używany jest typ kosztu MEDIA_SHARE. Wartość jest podana w mikrojednostkach (10^-6) i w walucie określonej w polu currencyCode. Na przykład 2000000 oznacza 2 PLN, jeśli currencyCode to USD.

Ma to znaczenie tylko wtedy, gdy costType ma wartość MEDIA_SHARE. Jeśli costType nie ma wartości MEDIA_SHARE, a to pole jest ustawione, zwracany jest błąd MAX_COST_NOT_ALLOWED. Jeśli zasada jest nieskonfigurowana lub ma wartość 0, nie ma limitu.

UserListPricingBuyerApprovalState

Stan zatwierdzenia przez kupującego cen listy użytkowników.

Wartości w polu enum
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED NIEOKREŚLONE.
PENDING Klient listy użytkowników nie zaakceptował jeszcze warunków cenowych określonych przez właściciela listy użytkowników.
APPROVED Klient listy użytkowników zaakceptował warunki cenowe ustalone przez właściciela listy użytkowników.
REJECTED Klient listy użytkowników odrzucił warunki cenowe ustalone przez właściciela listy użytkowników.

UserListPricingCostType

Typ kosztu ceny listy użytkowników.

Wartości w polu enum
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED Nie określono.
CPC koszt kliknięcia,
CPM Koszt tysiąca wyświetleń.
MEDIA_SHARE Udostępnianie multimediów.