REST Resource: curators.dataSegments

المورد: DataSegment

يحدّد معرّفًا لشريحة من المستودع الإعلاني يمكن للمنسّقين أو مخطّطي الوسائط استهدافها في واجهة مستخدم الصفقات أو حِزم المزادات. يتولّى المنسّقون تنسيق المستودع الإعلاني على منصات خارجية. -- المعرّف التالي: 9 --

تمثيل JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // Union field fee can be only one of the following:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of list of possible types for union field fee.
  "userListId": string
}
الحقول
name

string

غير قابل للتغيير. المعرّف. المعرّف الفريد لشريحة البيانات. يتطابق رقم تعريف الحساب مع رقم تعريف الحساب الذي أنشأ الشريحة. التنسيق: ‎curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}
createTime

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"
updateTime

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"
state

enum (State)

النتائج فقط. حالة شريحة البيانات
حقل الربط fee سيتم تحصيل رسوم عندما تستخدم حسابات أخرى شريحة البيانات هذه. على سبيل المثال، عندما تضيف حسابات أخرى شريحة البيانات هذه إلى صفقة أو حزمة مزاد. لا يمكن تغيير نوع الرسوم في شريحة البيانات بعد ضبطه. يمكن أن يكون fee واحدًا مما يلي فقط:
cpmFee

object (Money)

اختياريّ. رسوم ثابتة يتم تحصيلها لكل ألف ظهور بعد ضبط رمز العملة، لا يمكن تغييره.
millipercentOfMediaFee

string (int64 format)

اختياريّ. سيتم تحصيل الرسوم كنسبة مئوية من تكلفة الظهور، ويتم تمثيلها بالميلي في المئة. على سبيل المثال، يتم تمثيل% 1 على النحو 1000.
userListId

string

اختياريّ. غير قابل للتغيير. رقم تعريف قائمة المستخدمين التي تتضمّنها شريحة البيانات هذه

يمكن للمنسّقين الذين لديهم حساب شريك بيانات مرتبط إنشاء شريحة بيانات تتضمّن قائمة مستخدمين يملكها حساب شريك البيانات المرتبط. يمكن تحميل قوائم المستخدمين وإدارتها باستخدام Data Manager API. يتيح لك ربط قائمة مستخدمين بشريحة بيانات تحديد شريحة من المستودع الإعلاني استنادًا إلى جمهور تنشئه.

الولاية

النتائج فقط. استخدِم طريقة التفعيل والإلغاء لتغيير الحالة.

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية
ACTIVE شريحة البيانات مفعَّلة.
INACTIVE شريحة البيانات غير مفعَّلة.
SUSPENDED شريحة البيانات معلّقة ولا يمكن تفعيلها.

الطُرق

activate

 تفعيل شريحة بيانات

create

 إنشاء شريحة بيانات يملكها المنسّق المُدرَج

deactivate

 إلغاء تفعيل شريحة بيانات

get

 الحصول على شريحة بيانات حسب اسمها

list

 عرض شرائح البيانات التي يملكها منسّق

patch

 تعديل شريحة بيانات