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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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)

اختیاری. هزینه به صورت درصدی از هزینه نمایش، که به صورت میلی‌پردنت نشان داده می‌شود، دریافت می‌شود. به عنوان مثال، ۱٪ معادل ۱۰۰۰ است.

userListId

string

اختیاری. تغییرناپذیر. شناسه‌ی فهرست کاربران که توسط این بخش داده محصور شده است.

متصدیانی که دارای یک حساب کاربری مرتبط با Data Partner هستند می‌توانند یک بخش داده ایجاد کنند که فهرست کاربران متعلق به حساب کاربری مرتبط با Data Partner را در بر می‌گیرد. فهرست‌های کاربران را می‌توان با استفاده از رابط برنامه‌نویسی کاربردی مدیریت داده ( Data Manager API) بارگذاری و مدیریت کرد. پیوند دادن یک فهرست کاربر به یک بخش داده به شما امکان می‌دهد بخشی از موجودی را تعریف کنید که بر اساس مخاطبی که ایجاد می‌کنید، باشد.

ایالت

فقط خروجی. برای تغییر وضعیت از متدهای فعال‌سازی و غیرفعال‌سازی استفاده کنید.

انوم‌ها
STATE_UNSPECIFIED مقدار پیش‌فرض.
ACTIVE بخش داده فعال است.
INACTIVE بخش داده غیرفعال است.
SUSPENDED بخش داده به حالت تعلیق درآمده و قابل فعال‌سازی نیست.

روش‌ها

activate

 یک بخش داده را فعال می‌کند.

create

 یک بخش داده ایجاد می‌کند که متعلق به متصدی فهرست‌شده است.

deactivate

 یک بخش داده را غیرفعال می‌کند.

get

 یک بخش داده را با توجه به نام آن دریافت می‌کند.

list

 بخش‌های داده‌ای متعلق به یک متصدی را فهرست کنید.

patch

 یک بخش داده را به‌روزرسانی می‌کند.