REST Resource: curators.dataSegments

المورد: DataSegment

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "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)

النتائج فقط. حالة شريحة البيانات

سيتم تحصيل الرسوم عندما تستخدم حسابات أخرى شريحة البيانات هذه. على سبيل المثال، عندما تضيف حسابات أخرى شريحة البيانات هذه إلى صفقة أو حزمة مزاد. لا يمكن تغيير نوع الرسوم لشريحة البيانات بعد ضبطه. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
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

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