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

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

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

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

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

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

अनुरोध

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 अनुरोध किया गया है. अनुरोध को ऐसे एपीआई एंडपॉइंट पर भेजा जाता है जो बताए गए डेटा सेगमेंट में बदलाव करता है. साथ ही, यह सिर्फ़ DataSegment.cpmFee.nanos में बताए गए DataSegment.cpmFee.nanos फ़ील्ड में बदलाव करता है.updateMask

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

अनुरोध

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

अगले चरण