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 विज्ञापन देने वाले लोगों को, PAUSED या REMOVED स्थिति वाले पब्लिशर नहीं दिखते.
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

ज़रूरी नहीं. फ़्री फ़ॉर्म टेक्स्ट में सामान्य जानकारी. यह UTF-8 कोड में होना चाहिए. इसमें ज़्यादा से ज़्यादा 200 वर्ण हो सकते हैं. इस जानकारी में SOV(शेयर ऑफ़ वॉइस), सीपीडी, वॉल्यूम गारंटी के बारे में बताया जा सकता है. जानकारी का उदाहरण: "सीपीडी, हाई इंपैक्ट, औसतन 69% विज्ञापन दिखने से जुड़े आंकड़े"
tvMetadata

object (TVMetadata)

ज़रूरी नहीं. ऐसे पब्लिशर के लिए मेटाडेटा जिनके पास टीवी पर विज्ञापन दिखाने के विकल्प मौजूद हैं. जब मीडियम कैपेबिलिटी में टीवी शामिल हो, तब यह ज़रूरी है. जब मीडियम कैपेबिलिटी में टीवी शामिल न हो, तब यह लागू नहीं होता.
urgOwners[]

enum (UnderRepresentedGroup)

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

MediumCapability

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

Enums
MEDIUM_CAPABILITY_UNSPECIFIED मीडियम कैपेबिलिटी की जानकारी नहीं दी गई है. यह मान्य इनपुट नहीं है.
MEDIUM_CAPABILITY_DIGITAL मीडियम कैपेबिलिटी डिजिटल.
MEDIUM_CAPABILITY_TV मीडियम कैपेबिलिटी टीवी.
MEDIUM_CAPABILITY_AUDIO मीडियम कैपेबिलिटी ऑडियो.
MEDIUM_CAPABILITY_OOH मीडियम कैपेबिलिटी आउट ऑफ़ होम.

CommitmentCapability

कमिटमेंट कैपेबिलिटी 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

टीवी डिलीवरी टाइप enum.

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

तरीके

create

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

get

 इससे किसी पब्लिशर की जानकारी मिलती है.

list

 इससे पब्लिशर की सूची मिलती है.

patch

 इससे किसी पब्लिशर की जानकारी अपडेट होती है.
इससे पब्लिशर का लोगो अपलोड होता है.