REST Resource: videoContent.networks.sources.content

संसाधन: वीडियो कॉन्टेंट

कॉन्टेंट का मेटाडेटा.

JSON के काेड में दिखाना
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. वीडियो कॉन्टेंट के संसाधन का नाम. इस फ़ील्ड का फ़ॉर्मैट ऐसा है: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'

network_code, Google Ad Manager का वह नेटवर्क कोड है जिससे यह कॉन्टेंट जुड़ा है.

content_source_id, Google Ad Manager में मौजूद कॉन्टेंट सोर्स आईडी है, जिससे यह कॉन्टेंट जुड़ा होना चाहिए.

cms_content_id, Google Ad Manager में कॉन्टेंट मैनेजमेंट सिस्टम के लिए कॉन्टेंट आईडी है. इसे विज्ञापन अनुरोध के एक हिस्से के तौर पर बनाया जाता है, ताकि यह पता लगाया जा सके कि Ad Manager उससे जुड़े वीडियो पर कौनसे विज्ञापन दिखा सकता है. यह वैल्यू, अंक या अक्षर और अंक हो सकती है.

status

enum (VideoContentStatus)

कॉन्टेंट का स्टेटस. अगर इसे छोड़ दिया जाता है, तो डिफ़ॉल्ट वैल्यू चालू हो जाएगी.

title

string

ज़रूरी है. कॉन्टेंट का टाइटल.

updateTime

string (Timestamp format)

ज़रूरी है. कॉन्टेंट में पिछली बार बदलाव किए जाने का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

publishTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

कॉन्टेंट का कुल समय. समयावधि को मिलीसेकंड के लेवल तक सेट किया जाता है.

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

cuePoints[]

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

thumbnailUrl

string

कॉन्टेंट के थंबनेल का यूआरएल.

metadata

object (Metadata)

कॉन्टेंट के कस्टम मेटाडेटा की पहचान करता है.

gracenoteMetadata

object (GracenoteMetadata)

कॉन्टेंट के Gracenote से जुड़ा मेटाडेटा.

syndicationMetadata

object (VideoContentSyndicationInfo)

कॉन्टेंट का सिंडिकेशन से जुड़ा मेटाडेटा.

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

कॉन्टेंट का डाइनैमिक ऐड इंसर्शन से जुड़ा मेटाडेटा.

VideoContentStatus

किसी कॉन्टेंट के टारगेट किए गए विज्ञापन दिखाने या न दिखाने की स्थिति के विकल्प.

Enums
ACTIVE सामग्री-लक्ष्य विज्ञापन दिखाए जाएंगे.
BLOCKED अगर इस वीडियो के स्टेटस को ब्लॉक कर दिया जाता है, तो उस पर कोई विज्ञापन नहीं दिखाया जाएगा.
DELETED इसे Ad Manager में संग्रहित किया जाएगा. अगर Ad Manager को 'मिटाया गया' के तौर पर मार्क किए गए किसी कॉन्टेंट के लिए विज्ञापन अनुरोध मिलता है, तब भी उस पर हाउस विज्ञापन दिखाए जा सकते हैं. इसके अलावा, इन्वेंट्री यूनिट या टारगेटिंग की अन्य ज़रूरी शर्तों को टारगेट करने वाले विज्ञापन भी दिखाए जा सकते हैं. विज्ञापन ब्लॉक करने के लिए, स्टेटस को 'ब्लॉक किया गया' पर सेट करें.

मेटाडेटा

कॉन्टेंट का कस्टम मेटाडेटा.

JSON के काेड में दिखाना
{
  "keyValues": {
    string: value,
    ...
  }
}
फ़ील्ड
keyValues

map (key: string, value: value (Value format))

यह कॉन्टेंट के कस्टम मेटाडेटा की पहचान, की-वैल्यू पेयर के तौर पर करता है. वैल्यू के लिए सिर्फ़ स्ट्रिंग या स्ट्रिंग की सूची स्वीकार की जाती है.

GracenoteMetadata

कॉन्टेंट के लिए Gracenote मेटाडेटा.

JSON के काेड में दिखाना
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
फ़ील्ड
gracenoteId

string

ज़रूरी है. यह कॉन्टेंट के लिए Gracenote आईडी का रेफ़रंस देता है. इनमें से कोई एक मान्य प्रीफ़िक्स होना चाहिए: 1. 'ईपी' - सीरीज़ 2 का एपिसोड. 'संगीत वीडियो' - मूवी 3. 'एसपी' - खेल-कूद से जुड़ा इवेंट

gracenoteSeriesId

string

ज़रूरी नहीं. यह फ़ील्ड Gracenote सीरीज़ के आईडी को दिखाता है. 'SH' की शुरुआत में होना चाहिए.

VideoContentSyndicationInfo

कैननिकल कॉन्टेंट और सिंडिकेटेड कॉन्टेंट के बीच संबंध बताने के लिए मेटाडेटा.

JSON के काेड में दिखाना
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
फ़ील्ड
यूनियन फ़ील्ड syndication. VideoContentSyndiationMetadata में, इनमें से सिर्फ़ एक चीज़ शामिल की जा सकती है. syndication इनमें से सिर्फ़ एक हो सकता है:
canonicalVideoContent

string

कैननिकल कॉन्टेंट का नाम. इसका फ़ॉर्मैट "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" की तरह होना चाहिए और इस फ़ील्ड वाले कॉन्टेंट के नेटवर्क से ही जुड़ा होना चाहिए.

syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

सिंडिकेटेड कॉन्टेंट का कलेक्शन

SyndicatedVideoContentNames

ऑफ़लाइन बांटे गए सभी कॉन्टेंट के नामों की सूची.

JSON के काेड में दिखाना
{
  "syndicatedVideoContent": [
    string
  ]
}
फ़ील्ड
syndicatedVideoContent[]

string

ऑफ़लाइन बांटे गए कॉन्टेंट के नाम का दोहराया गया फ़ील्ड. उनका फ़ॉर्मैट ऐसा होना चाहिए "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" और इस फ़ील्ड वाले कॉन्टेंट के नेटवर्क से ही जुड़ा होना चाहिए.

DynamicAdInsertionInfo

डाइनैमिक ऐड इंसर्शन के बारे में जानकारी.

JSON के काेड में दिखाना
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
फ़ील्ड
videoIngestUrlInfo

object (VideoIngestUrlInfo)

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

mediaUpdateTime

string (Timestamp format)

videoIngetUrlInfo में रेफ़र की गई वीडियो फ़ाइल में पिछली बार बदलाव किए जाने का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

सबटाइटल/सबटाइटल फ़ाइल का यूआरएल.

fwCaid

string

विज्ञापन टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) के लिए इस्तेमाल किया जाने वाला फ़्रीव्हील कस्टम ऐसेट आईडी.

VideoIngestUrlInfo

m3u8 फ़ाइल का लिंक बताने वाला मेटाडेटा, जिसका इस्तेमाल कंडीशनिंग और प्लेलिस्ट बनाने के लिए किया जाता है.

JSON के काेड में दिखाना
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
फ़ील्ड
videoFormat

enum (VideoFormat)

वीडियो का फ़ॉर्मैट.

videoPreconditioned

enum (VideoPreconditioned)

यह बताने के लिए कि वीडियो के बीच में विज्ञापन दिखाए जा सकते हैं या नहीं, इसका मतलब है कि विज्ञापन के लिए ब्रेक के समय पहले ही सेगमेंट अलग-अलग कर दिए गए हैं.

url

string

m3u8 फ़ाइल का लिंक.

VideoFormat

वे फ़ॉर्मैट जिनमें वीडियो कॉन्टेंट को कोड में बदला जा सकता है.

Enums
VIDEO_FORMAT_UNSPECIFIED वीडियो का फ़ॉर्मैट नहीं बताया गया.
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

वीडियो कॉन्टेंट की स्थिति.

Enums
NO अभी तक तय नहीं है.
YES वीडियो को कंडिशन/स्प्लिट कर दिया गया है.

ClosedCaptionUrlInfo

सबटाइटल वाली एक फ़ाइल का मेटाडेटा.

JSON के काेड में दिखाना
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
फ़ील्ड
languageCode

string

आईईटीएफ़ बीसीपी-47 भाषा कोड उस भाषा को दिखाता है जिसमें सबटाइटल फ़ाइल है.

closedCaptionFormat

enum (ClosedCaptionFormat)

सबटाइटल फ़ाइल का फ़ॉर्मैट.

url

string

सबटाइटल फ़ाइल का यूआरएल.

ClosedCaptionFormat

ऐसे फ़ॉर्मैट जिनमें सबटाइटल फ़ाइलें हो सकती हैं.

Enums
CLOSED_CAPTION_FORMAT_UNSPECIFIED सबटाइटल का फ़ॉर्मैट नहीं दिया गया था.
TTML application/ttaf+xml
WEB_VTT text/vtt

तरीके

update

अगर Ad Manager में कॉन्टेंट पहले से मौजूद है, तो नया कॉन्टेंट बनाने या इसके मेटाडेटा को अपडेट करने के लिए एपीआई.