डेटा सेगमेंट बनाना और उनमें बदलाव करना

नया डेटा सेगमेंट बनाना

curators.dataSegments.create तरीके का इस्तेमाल करके, नया डेटा सेगमेंट बनाया जा सकता है. डेटा सेगमेंट बनाने के बाद, वह ACTIVE स्थिति में होता है. इससे रीयल-टाइम बिडिंग में काम करने वाले डील या पैकेज, डेटा सेगमेंट को टारगेट कर पाते हैं.

डेटा सेगमेंट को मीडिया प्लानर के लिए उपलब्ध कराने के लिए, आपको क्योरेटेड यूज़र इंटरफ़ेस (यूआई) के डेटा सेगमेंट सेटिंग टैब में जाकर, सेगमेंट की उपलब्धता को चालू करना होगा. इससे मीडिया प्लानर, डील या पैकेज को टारगेट कर पाएंगे.

नीचे दिए गए उदाहरण में, POST ऑब्जेक्ट वाले JSON मुख्य हिस्से के साथ एचटीटीपी POST अनुरोध किया गया है.DataSegment अनुरोध को ऐसे एपीआई एंडपॉइंट पर भेजा जाता है जो दिए गए कॉन्फ़िगरेशन के हिसाब से डेटा सेगमेंट बनाता है.

एपीआई कॉल के लिए कर्ल का उदाहरण

अनुरोध

curl --request POST \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"cpmFee":{"nanos":100,"units":0,"currencyCode":"USD"},"name":"curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2"}' \
--compressed

जवाब

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
  "createTime": "2025-08-14T17:45:08.744379Z",
  "updateTime": "2025-08-14T17:45:08.744379Z",
  "cpmFee": {
    "currencyCode": "USD",
    "nanos": 100
  },
  "state": "ACTIVE"
}

मौजूदा डेटा सेगमेंट में बदलाव करना

किसी मौजूदा डेटा सेगमेंट में बदलाव करने के लिए, curators.dataSegments.patch तरीके का इस्तेमाल किया जा सकता है. उदाहरण के लिए, इस तरीके का इस्तेमाल करके डेटा सेगमेंट के लिए cpmFee फ़ील्ड में बदलाव करें.

नीचे दिए गए उदाहरण में, DataSegment ऑब्जेक्ट वाले JSON बॉडी के साथ एचटीटीपी PATCH अनुरोध किया गया है. अनुरोध को ऐसे एपीआई एंडपॉइंट पर भेजा जाता है जो बताए गए डेटा सेगमेंट में बदलाव करता है. साथ ही, यह सिर्फ़ updateMask में बताए गए DataSegment.cpmFee.nanos फ़ील्ड में बदलाव करता है.

एपीआई कॉल के लिए कर्ल का उदाहरण

अनुरोध

curl --request PATCH \
  'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2?updateMask=cpmFee.nanos&key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json'  \
  --data '{"cpmFee":{"nanos":50}}' \
  --compressed

जवाब

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
  "createTime": "2025-08-14T17:45:08.744Z",
  "updateTime": "2025-08-14T17:56:02.200619Z",
  "cpmFee": {
    "currencyCode": "USD",
    "nanos": 50
  },
  "state": "ACTIVE"
}

अगले चरण