नया डेटा सेगमेंट बनाना
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"
}
अगले चरण
- Marketplace API की मदद से, डेटा सेगमेंट चालू और बंद करने का तरीका जानें.
- Marketplace API की मदद से, अपने डेटा सेगमेंट देखने का तरीका जानें.
- रीयल-टाइम में कॉन्टेंट को व्यवस्थित करने के बारे में जानकारी पढ़ें.
- रीयल-टाइम क्युरेशन में, आने वाले सेगमेंट के अनुरोधों को पार्स करने का तरीका जानें.