REST Resource: exchanges.publishers

संसाधन: पब्लिशर

इसमें एक पब्लिशर शामिल होता है.

JSON के काेड में दिखाना
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. इस पब्लिशर के लिए रिलेटिव रूट का नाम. यह इस फ़ॉर्मैट में होना चाहिए: "exchanges/{seller_id}/publishers/{publisherId} उदाहरण: "exchanges/1234/publishers/5678".

externalPublisherId

string

ज़रूरी है. [DEPRECATED] इस फ़ील्ड की जगह जल्द ही externalPublisherIds[] का इस्तेमाल किया जाएगा. एक्सचेंज ने यूनीक पब्लिशर आईडी दिया है. यह आईडी, बिड रिक्वेस्ट में भेजे गए पब्लिशर आईडी से मेल खाना चाहिए.

ज़्यादा से ज़्यादा 100 वर्ण. इसमें अक्षर, अंक, अंडरस्कोर, डैश, और बिंदु का इस्तेमाल किया जा सकता है.

externalPublisherIds[]

string

ज़रूरी नहीं. एक्सचेंज की ओर से उपलब्ध कराए गए पब्लिशर आईडी. हर आईडी यूनीक होना चाहिए और बिड रिक्वेस्ट में भेजे गए पब्लिशर आईडी से मेल खाना चाहिए.

ज़्यादा से ज़्यादा 10 गिनती. हर आईडी में ज़्यादा से ज़्यादा 100 वर्ण होने चाहिए. इसमें अक्षर, अंक, अंडरस्कोर, डैश, और बिंदु का इस्तेमाल किया जा सकता है.

displayName

string

ज़रूरी है. इस पब्लिशर का डिसप्ले नेम. यह UTF-8 कोड में होना चाहिए और इसमें ज़्यादा से ज़्यादा 30 वर्ण होने चाहिए.

status

enum (DiscoveryObjectStatus)

ज़रूरी है. इस पब्लिशर का स्टेटस. जिन पब्लिशर की स्थिति 'रोका गया' या 'हटाया गया' है उन्हें DV3 का इस्तेमाल करने वाले विज्ञापन देने वालों को नहीं दिखाया जाता.

mediumCapability

enum (MediumCapability)

ज़रूरी है. वह मीडिया जिस पर इस पब्लिशर को अपने विज्ञापन होस्ट करने हैं.

description

string

ज़रूरी है. इस पब्लिशर के लिए ब्यौरा. यह UTF-8 कोड में होना चाहिए और इसमें ज़्यादा से ज़्यादा 1,000 वर्ण होने चाहिए. ज़रूरी है.

contactInfo[]

string

ज़रूरी है. विज्ञापन देने वाले लोगों या कंपनियों के लिए, पब्लिशर से संपर्क करने के लिए ईमेल पते. ज़्यादा से ज़्यादा 10 संपर्क. हर संपर्क में ज़्यादा से ज़्यादा 100 वर्ण होने चाहिए. उदाहरण: [अमेरिका में संपर्क - जॉन स्मिथ: john.smith@abc.com]. ज़रूरी है.

commitmentCapability[]

enum (CommitmentCapability)

ज़रूरी नहीं. इस पब्लिशर के लिए, कमिटमेंट के टाइप.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

ज़रूरी है. इस पब्लिशर की इन्वेंट्री के लिए, अनुमानित ब्रेकडाउन. DV3 का इस्तेमाल करने वाले विज्ञापन देने वाले, इन ब्रेकडाउन को देख सकते हैं और फ़िल्टर कर सकते हैं. डोमेन के लिए अनुमान का ब्रेकडाउन देना ज़रूरी है.

logoUrl

string

सिर्फ़ आउटपुट के लिए. इस पब्लिशर के लोगो का यूआरएल.

floorPrice

object (Money)

ज़रूरी नहीं. इस पब्लिशर की तय की गई कम से कम कीमत. सीलिंग कीमत के साथ मुद्रा कोड एक ही होना चाहिए.

ceilingPrice

object (Money)

ज़रूरी नहीं. इस पब्लिशर की तय की गई ज़्यादा से ज़्यादा कीमत. फ़्लोर प्राइस के साथ एक ही मुद्रा कोड होना चाहिए.

generalCapability

string

ज़रूरी नहीं.

tvMetadata

object (TVMetadata)

ज़रूरी नहीं. ऐसे पब्लिशर का मेटाडेटा जिसके पास टीवी ऑफ़र हैं. अगर मीडियम कैपेबिलिटी में टीवी शामिल है, तो यह एट्रिब्यूट देना ज़रूरी है. अगर मीडियम कैपेबिलिटी में टीवी शामिल नहीं है, तो यह शर्त लागू नहीं होती.

urgOwners[]

enum (UnderRepresentedGroup)

ज़रूरी नहीं. ऐसे ग्रुप जिनमें कम प्रतिनिधित्व वाले समुदायों के लोग शामिल हैं. अगर कोई ग्रुप है, तो मालिक उस ग्रुप का सदस्य होना चाहिए.

MediumCapability

मीडियम कैपेबिलिटी एनम. DV360 के इन्वेंट्री मॉड्यूल में मौजूद मार्केटप्लेस फ़्रंटएंड में, इन्वेंट्री के लिए अलग-अलग सेक्शन शामिल होते हैं. "डिजिटल: इसमें डिसप्ले, वीडियो (इसमें सीटीवी और ओटीटी शामिल हैं), और ऑडियो इन्वेंट्री में मौजूद पब्लिशर और नीलामी पैकेज शामिल हैं." "टीवी: यह सीटीवी और ओटीटी इन्वेंट्री को खोजने के लिए, हाल ही में लॉन्च किया गया हमारा नया सेक्शन है. CTV और OTT के बारे में यहां बताया गया है: "कनेक्टेड टीवी (CTV) में वे सभी डिवाइस शामिल हैं जो इन कैटगरी में आते हैं: - कनेक्टेड या स्ट्रीमिंग डिवाइस: वीडियो स्ट्रीम दिखाने के लिए, टीवी स्क्रीन से कनेक्ट होने वाले डिवाइस (Roku, Apple TV वगैरह) - स्मार्ट टीवी: इंटरनेट कनेक्शन वाले टीवी (Samsung स्मार्ट टीवी वगैरह) - गेम कंसोल: इंटरनेट से कनेक्ट किए गए गेम कंसोल (Xbox, PlayStation, Wii वगैरह) - सेट-टॉप बॉक्स: ये डिवाइस, पारंपरिक केबल और मांग पर वीडियो (वीओडी) कॉन्टेंट डिलीवर करते हैं." "ओवर द टॉप (ओटीटी) का मतलब है, टेलीकॉम और केबल सेवा देने वाली कंपनियों के क्लोज़्ड नेटवर्क के बाहर, इंटरनेट पर वीडियो सेवा देने वाली कंपनी से मिलने वाला टीवी जैसा वीडियो कॉन्टेंट. ओटीटी वीडियो को डेस्कटॉप, मोबाइल, टैबलेट के साथ-साथ सीटीवी या एसटीबी डिवाइसों पर देखा जा सकता है. हालांकि, इसके लिए ज़रूरी है कि सीटीवी या एसटीबी डिवाइसों पर कॉन्टेंट को आईपी के ज़रिए डिलीवर किया जा रहा हो. "ऑडियो: यह ऑडियो इन्वेंट्री के लिए, हाल ही में लॉन्च किया गया सेक्शन है." "डीओओएच: डिजिटल आउट-ऑफ़-होम पब्लिशर."

Enums
MEDIUM_CAPABILITY_UNSPECIFIED मीडियम कैपेबिलिटी के बारे में जानकारी नहीं दी गई है. इनपुट अमान्य है.
MEDIUM_CAPABILITY_DIGITAL मीडियम कैपेसिटी वाला डिजिटल.
MEDIUM_CAPABILITY_TV सामान्य सुविधाओं वाला टीवी.
MEDIUM_CAPABILITY_AUDIO मीडियम क्वालिटी का ऑडियो.
MEDIUM_CAPABILITY_OOH घर से बाहर की सुविधाएं सामान्य हैं.

CommitmentCapability

Commitment capability enum.

Enums
COMMITMENT_CAPABILITY_UNSPECIFIED 'कंपनी की क्षमता' एट्रिब्यूट की वैल्यू नहीं दी गई है. इनपुट अमान्य है.
COMMITMENT_CAPABILITY_GUARANTEED पब्लिशर के पास गारंटी वाली इन्वेंट्री है.
COMMITMENT_CAPABILITY_NON_GUARANTEED पब्लिशर के पास बिना गारंटी वाली इन्वेंट्री है.

TVMetadata

उन पब्लिशर के लिए मेटाडेटा जिनके पास टीवी ऑफ़र हैं.

JSON के काेड में दिखाना
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
फ़ील्ड
tvDeliveryType

enum (TVDeliveryType)

ज़रूरी है. टीवी विज्ञापनों की डिलीवरी का टाइप.

topShows[]

string

ज़रूरी नहीं. पब्लिशर के मालिकाना हक वाले टॉप टीवी शो के टाइटल की सूची. ज़्यादा से ज़्यादा 10. यह UTF-8 कोड में होना चाहिए.

TVDeliveryType

टीवी डिलीवरी टाइप की सूची.

Enums
TV_DELIVERY_TYPE_UNSPECIFIED टीवी डिलीवरी के टाइप की जानकारी नहीं दी गई. इनपुट अमान्य है.
TV_DELIVERY_TYPE_CTV टीवी डिलीवरी टाइप कनेक्टेड टीवी.
TV_DELIVERY_TYPE_LINEAR_TV टीवी डिलीवरी टाइप लीनियर टीवी.

तरीके

create

नया पब्लिशर बनाता है.

get

पब्लिशर मिलता है.

list

पब्लिशर की सूची दिखाता है.

patch

पब्लिशर को अपडेट करता है.
पब्लिशर का लोगो अपलोड करें.