Package google.ads.drx.video.v1

इंडेक्स

VideoContentIngestionService

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

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

अगर कॉन्टेंट Ad Manager में पहले से मौजूद है, तो नया कॉन्टेंट बनाने या उसके मेटाडेटा को अपडेट करने के लिए एपीआई. यह फ़ंक्शन, अनुरोध पूरा होने पर कॉन्टेंट दिखाता है. अगर अनुरोध पूरा नहीं होता है, तो google.rpc.Code दिखाता है.

अनुरोध का उदाहरण:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

ज़्यादा जानकारी के लिए, OAuth 2.0 के बारे में खास जानकारी देखें.

ClosedCaptionFormat

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

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

ClosedCaptionUrlInfo

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

फ़ील्ड
language_code

string

यह IETF BCP-47 भाषा कोड, उस भाषा को दिखाता है जिसमें सबटाइटल फ़ाइल मौजूद है.

closed_caption_format

ClosedCaptionFormat

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

url

string

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

DynamicAdInsertionInfo

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

फ़ील्ड
video_ingest_url_info

VideoIngestUrlInfo

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

media_update_time

Timestamp

वीडियो_इंजस्ट_यूआरएल_जानकारी में दी गई वीडियो फ़ाइल में पिछली बार बदलाव कब किया गया था.

closed_caption_url_info[]

ClosedCaptionUrlInfo

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

fw_caid

string

यह Freewheel का कस्टम ऐसेट आईडी है. इसका इस्तेमाल विज्ञापन टारगेटिंग के लिए किया जाता है.

GracenoteMetadata

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

फ़ील्ड
gracenote_id

string

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

gracenote_series_id

string

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

मेटाडेटा

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

फ़ील्ड
key_values

map<string, Value>

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

SyndicatedVideoContentNames

सिंडिकेट किए गए सभी कॉन्टेंट के नामों की सूची.

फ़ील्ड
syndicated_video_content[]

string

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

UpdateVideoContentRequest

[VideoContentIngestionService.UpdateVideoContentRequest][] के लिए अनुरोध.

फ़ील्ड
video_content

VideoContent

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

वीडियो सामग्री

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

फ़ील्ड
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

VideoContentStatus

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

title

string

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

update_time

Timestamp

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

publish_time

Timestamp

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

duration

Duration

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

cue_points[]

Duration

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

thumbnail_url

string

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

metadata

Metadata

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

gracenote_metadata

GracenoteMetadata

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

syndication_metadata

VideoContentSyndicationInfo

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

dynamic_ad_insertion_metadata

DynamicAdInsertionInfo

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

VideoContentStatus

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

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

VideoContentSyndicationInfo

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

फ़ील्ड
यूनियन फ़ील्ड syndication. VideoContentSyndicationMetadata में इनमें से सिर्फ़ एक वैल्यू हो सकती है. syndication इनमें से सिर्फ़ एक हो सकता है:
canonical_video_content

string

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

syndicated_video_content_names

SyndicatedVideoContentNames

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

VideoFormat

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

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

VideoIngestUrlInfo

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

फ़ील्ड
video_format

VideoFormat

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

video_preconditioned

VideoPreconditioned

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

url

string

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

VideoPreconditioned

वीडियो कॉन्टेंट की शर्त पूरी होने की स्थिति.

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