UserListLicensePricing

أسعار تراخيص قوائم المستخدمين

تمثيل JSON 
{
  "pricingId": string,
  "startTime": string,
  "endTime": string,
  "pricingActive": boolean,
  "buyerApprovalState": enum (UserListPricingBuyerApprovalState),
  "costMicros": string,
  "currencyCode": string,
  "costType": enum (UserListPricingCostType),
  "maxCostMicros": string
}
الحقول
pricingId

string (int64 format)

النتائج فقط. تمثّل هذه السمة معرّف السعر.
startTime

string (Timestamp format)

النتائج فقط. تمثّل هذه السمة وقت بدء السعر.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

اختياريّ. وقت انتهاء السعر

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
pricingActive

boolean

النتائج فقط. تحديد ما إذا كان هذا السعر نشطًا
buyerApprovalState

enum (UserListPricingBuyerApprovalState)

النتائج فقط. حالة الموافقة على هذا السعر من قِبل المشتري

هذا الحقل مخصّص للقراءة فقط.
costMicros

string (int64 format)

اختياريّ. تمثّل هذه السمة التكلفة المرتبطة بالنموذج بوحدات ميكرو (10^-6)، وذلك بالعملة المحدّدة في الحقل currencyCode. على سبيل المثال، يعني الرقم 2000000 دولار أمريكي إذا كانت قيمة currencyCode هي USD.
currencyCode

string

اختياريّ. العملة التي يتم تحديد التكلفة وmax_cost بها. يجب أن يكون رمز عملة مكوّنًا من ثلاثة أحرف ومحدّدًا في معيار ISO 4217.
costType

enum (UserListPricingCostType)

غير قابل للتغيير تمثّل هذه السمة نوع التكلفة لهذا السعر.

يمكن ضبطها فقط في عملية create. لا يمكن تعديلها لترخيص حالي.
maxCostMicros

string (int64 format)

اختياريّ. الحدّ الأقصى للتكلفة لكل ألف ظهور التي يمكن تحصيلها من جمهور التجارة عند استخدام نوع التكلفة MEDIA_SHARE. تكون القيمة بوحدات ميكرو (10^-6) وبالعملة المحدّدة في حقل currencyCode. على سبيل المثال، يعني الرقم 2000000 دولار أمريكي إذا كانت قيمة currencyCode هي USD.

لا يكون هذا الحقل ذا صلة إلا عندما تكون قيمة costType هي MEDIA_SHARE. عندما لا يكون costType هو MEDIA_SHARE ويتم ضبط هذا الحقل، سيتم عرض الخطأ MAX_COST_NOT_ALLOWED. في حال عدم ضبط السياسة أو ضبطها على0، لن يكون هناك حد أقصى.

UserListPricingBuyerApprovalState

حالة الموافقة على المشتري في ما يتعلّق بأسعار قوائم المستخدمين

عمليات التعداد
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED UNSPECIFIED.
PENDING لم يقبل عميل قائمة المستخدمين بعد بنود الأسعار التي وضعها مالك قائمة المستخدمين.
APPROVED قبل عميل قائمة المستخدمين بنود الأسعار التي حدّدها مالك قائمة المستخدمين.
REJECTED رفض عميل قائمة المستخدمين بنود الأسعار التي حدّدها مالك قائمة المستخدمين.

UserListPricingCostType

نوع تكلفة تسعير قائمة المستخدمين:

عمليات التعداد
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED غير محدد
CPC تكلفة النقرة
CPM التكلفة لكل ألف ظهور
MEDIA_SHARE مشاركة الوسائط