REST Resource: curators.dataSegments

संसाधन: DataSegment

यह इन्वेंट्री के किसी सेगमेंट के लिए आइडेंटिफ़ायर तय करता है. इसे डील या नीलामी पैकेज के यूज़र इंटरफ़ेस (यूआई) में, क्यूरेटर या मीडिया प्लानर टारगेट कर सकते हैं. इन्वेंट्री को बाहरी प्लैटफ़ॉर्म पर क्यूरेटर मैनेज करते हैं. -- अगला आईडी: 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)

सिर्फ़ आउटपुट के लिए. डेटा सेगमेंट बनाए जाने का समय.

यह आरएफ़सी 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)

सिर्फ़ आउटपुट के लिए. डेटा सेगमेंट को पिछली बार अपडेट किए जाने का समय.

यह आरएफ़सी 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 का इस्तेमाल करके, उपयोगकर्ता सूचियां अपलोड और मैनेज की जा सकती हैं. उपयोगकर्ता सूची को डेटा सेगमेंट से लिंक करने पर, इन्वेंट्री का ऐसा सेगमेंट तय किया जा सकता है जो आपकी बनाई गई ऑडियंस पर आधारित हो.

राज्य

सिर्फ़ आउटपुट के लिए. स्थिति बदलने के लिए, चालू और बंद करने के तरीके का इस्तेमाल करें.

Enums
STATE_UNSPECIFIED डिफ़ॉल्ट मान.
ACTIVE डेटा सेगमेंट चालू है.
INACTIVE डेटा सेगमेंट इनऐक्टिव है.
SUSPENDED डेटा सेगमेंट को निलंबित कर दिया गया है और उसे चालू नहीं किया जा सकता.

तरीके

activate

इससे कोई डेटा सेगमेंट चालू होता है.

create

इससे सूची में मौजूद क्यूरेटर के मालिकाना हक वाला डेटा सेगमेंट बनता है.

deactivate

यह किसी डेटा सेगमेंट को बंद करता है.

get

नाम के आधार पर डेटा सेगमेंट फ़ेच करता है.

list

किसी क्यूरेटर के मालिकाना हक वाले डेटा सेगमेंट की सूची बनाएं.

patch

डेटा सेगमेंट को अपडेट करता है.