Package google.ads.drx.video.v1

इंडेक्स

AdBreakNotificationService

एपीआई की सेवा, जिसकी मदद से पब्लिशर लाइव स्ट्रीम में विज्ञापन के लिए ब्रेक बना सकते हैं.

विज्ञापन ब्रेक बनाएं

rpc CreateAdBreak(CreateAdBreakRequest) returns (AdBreak)

लाइव स्ट्रीम में विज्ञापन के लिए ब्रेक बनाने के लिए एपीआई.

अनुमति पाने के लिंक

इनमें से किसी एक OAuth दायरे की ज़रूरत होती है:

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

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

rpc ListAdBreaks(ListAdBreaksRequest) returns (ListAdBreaksResponse)

लाइव स्ट्रीम में विज्ञापन के लिए ब्रेक जोड़ने के लिए एपीआई.

अनुमति पाने के लिंक

इनमें से किसी एक OAuth दायरे की ज़रूरत होती है:

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

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

VideoContentIngsionसेवा

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

VideoContent को अपडेट करें

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

अगर एपीआई पहले से मौजूद है, तो नया कॉन्टेंट बनाने या उसके मेटाडेटा को अपडेट करने के लिए एपीआई. सफलता पर कॉन्टेंट दिखाता है या नहीं मिलने पर, 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 की खास जानकारी देखें.

विज्ञापन ब्रेक

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

फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए है. विज्ञापन के लिए ब्रेक का संसाधन नाम. इस फ़ील्ड का फ़ॉर्मैट "/networks//एसेट//adBreaks/" होगा.

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

Google Ad Manager में लाइव स्ट्रीम इवेंट के लिए, asset_key एक अहम कुंजी है. इसी इवेंट के तहत विज्ञापन ब्रेक बनाया गया था.

ad_Break_id, विज्ञापन के लिए ब्रेक का मुख्य हिस्सा है. सिर्फ़ आउटपुट.
expected_duration

Duration

ज़रूरी है. ब्रेक का अनुमानित समय.
custom_params

string

Ad Manager में कस्टम मानदंड टारगेटिंग के लिए इस ब्रेक के लिए, विज्ञापन अनुरोधों में शामिल किए जाने वाले की-वैल्यू पेयर. उदाहरण: 'key1=value&key2=value2,value22'
scte_35_cue_out

string

scte35 क्यू से लिया गया बेस 64 एन्कोड किया गया डेटा. इसमें splice_insert() या time_signal() कमांड शामिल हो सकता है. उदाहरण: - time_signal() के साथ: “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAASOKGKNAIAmsnRfg==” - splice_insert() के साथ: "/DAvAAAAAAAAAA//WFAVIAACPf+/+222
pod_template_name

string

Google Ad Manager पॉड टेंप्लेट का नाम.
break_state

BreakState

विज्ञापन के लिए ब्रेक की मौजूदा स्थिति.

ब्रेकस्टेट

'विज्ञापन के लिए ब्रेक' की स्थिति.

Enums
BREAK_STATE_UNSPECIFIED विज्ञापन के लिए ब्रेक की स्थिति की जानकारी नहीं है.
BREAK_STATE_DECISIONED विज्ञापन के लिए ब्रेक का फ़ैसला लिया गया था, लेकिन अब तक उपयोगकर्ताओं को डिलीवर नहीं किया गया है.
BREAK_STATE_COMPLETE उपयोगकर्ताओं को विज्ञापन का ब्रेक दिया गया.

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

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

Enums
CLOSED_CAPTION_FORMAT_UNSPECIFIED सबटाइटल का फ़ॉर्मैट तय नहीं किया गया.
TTML ऐप्लिकेशन/TAf+xml
WEB_VTT टेक्स्ट/वीटीटी

ClosedcaptionUrlInfo

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

फ़ील्ड
language_code

string

IETF BCP-47 भाषा कोड उस भाषा को दर्शाता है जिसमें सबटाइटल फ़ाइल है.
closed_caption_format

ClosedCaptionFormat

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

string

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

विज्ञापन-ब्रेक अनुरोध बनाएं

AdBreakNotificationService.CreateAdBreak की मांग.

फ़ील्ड
parent

string

यह फ़ील्ड उस LiveStreamEvent की पहचान करता है, जिसे यह विज्ञापन ब्रेक लाइव स्ट्रीम एसेट कुंजी का इस्तेमाल करने के लिए जोड़ा जाना चाहिए. इसका फ़ॉर्मैट {0}networks/{network_code}/asset/{asset_code}" होना ज़रूरी है
custom_parent

string

यह फ़ील्ड उस LiveStreamEvent की पहचान करता है, जिसे इस विज्ञापन ब्रेक को कस्टम एसेट कुंजी का इस्तेमाल करने के लिए संबंधित करना चाहिए. इसका फ़ॉर्मैट {0}networks/{network_code}/customAssets/{asset_code}" होना ज़रूरी है
content

string

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

AdBreak

ज़रूरी है. असल में विज्ञापन ब्रेक.
ad_break_id

string

यह ad_Break_id होता है जिसे उपयोगकर्ता अनुरोध के ज़रिए दे सकते हैं.

DynamicAdInsertionInfo

डाइनैमिक विज्ञापन इंसर्शन की जानकारी.

फ़ील्ड
video_ingest_url_info

VideoIngestUrlInfo

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

Timestamp

video_ingest_url_info में पिछली बार बदलाव की गई वीडियो फ़ाइल.
closed_caption_url_info[]

ClosedCaptionUrlInfo

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

string

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

Gracenoteमेटाडेटा

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

फ़ील्ड
gracenote_id

string

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

string

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

ListAdBreaksRequest

AdBreakNotificationService.ListAdBreaks की मांग.

फ़ील्ड
parent

string

ज़रूरी नहीं. यह फ़ील्ड उस LiveStreamEvent की पहचान करता है, जिसे यह विज्ञापन ब्रेक लाइव स्ट्रीम एसेट कुंजी का इस्तेमाल करने के लिए जोड़ा जाना चाहिए. इसका फ़ॉर्मैट {0}networks/{network_code}/asset/{asset_code}" होना ज़रूरी है
custom_parent

string

ज़रूरी नहीं. यह फ़ील्ड उस LiveStreamEvent की पहचान करता है, जिसे इस विज्ञापन ब्रेक को कस्टम एसेट कुंजी का इस्तेमाल करने के लिए संबंधित करना चाहिए. इसका फ़ॉर्मैट {0}networks/{network_code}/customAssets/{asset_code}" होना ज़रूरी है
content

string

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

int32

ज़रूरी नहीं. दिखाई जाने वाली विज्ञापन ब्रेक की अधिकतम संख्या. सेवा इस वैल्यू से कम वैल्यू दिखा सकती है. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10 विज्ञापन ब्रेक दिखाए जाएंगे. ज़्यादा से ज़्यादा वैल्यू 100 है. 100 से ज़्यादा की वैल्यू को 100 किया जाएगा.
page_token

string

ज़रूरी नहीं. पिछले ListAdBreaks कॉल से मिला पेज टोकन. बाद के पेज को फिर से पाने के लिए इसे उपलब्ध कराएं.

पेजों को क्रम में लगाते समय ListAdBreaks के लिए दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए.

ListAdBreaksResponse

AdBreakNotificationService.ListAdBreaks का जवाब.

फ़ील्ड
ad_breaks[]

AdBreak

सिर्फ़ आउटपुट के लिए है. अनुरोध किए गए LiveStreamEvent से मेल खाने वाले विज्ञापन ब्रेक की सूची.
next_page_token

string

टोकन, जिसे अगला पेज फिर से पाने के लिए page_token के तौर पर भेजा जा सकता है. अगर यह फ़ील्ड नहीं डाला गया, तो इसके बाद कोई पेज नहीं होता है.

मेटाडेटा

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

फ़ील्ड
key_values

map<string, Value>

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

सिंडिकेट किए गए वीडियोकॉन्टेंट के नाम

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

फ़ील्ड
syndicated_video_content[]

string

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

VideoContentRequest को अपडेट करें

[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 में सीएमएस कॉन्टेंट का आईडी होता है. इसे विज्ञापन अनुरोध के हिस्से के तौर पर बनाया जाता है, ताकि यह पता लगाया जा सके कि मिलते-जुलते वीडियो के लिए, विज्ञापन मैनेजर कौनसे विज्ञापन दिखा सकता है. यह वैल्यू, अक्षर और अंक हो सकते हैं.
status

VideoContentStatus

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

string

ज़रूरी है. कॉन्टेंट का शीर्षक.
update_time

Timestamp

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

Timestamp

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

Duration

कॉन्टेंट का कुल समय. यह अवधि, मिलीसेकंड लेवल तक काम करती है.
cue_points[]

Duration

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

string

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

Metadata

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

GracenoteMetadata

कॉन्टेंट से जुड़ा, ग्रेड नोट से जुड़ा मेटाडेटा.
syndication_metadata

VideoContentSyndicationInfo

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

DynamicAdInsertionInfo

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

VideoContentStatus

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

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

VideoContentSyndication की जानकारी

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

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

string

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

SyndicatedVideoContentNames

सिंडिकेट किए गए कॉन्टेंट का संग्रह

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

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

Enums
VIDEO_FORMAT_UNSPECIFIED वीडियो प्रारूप नहीं बताया गया.
HLS ऐप्लिकेशन/x-mpegURL
DASH ऐप्लिकेशन/डैश+xml

VideoIngestUrlInfo

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

फ़ील्ड
video_format

VideoFormat

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

VideoPreconditioned

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

string

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

वीडियो प्री-कंडिशनल

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

Enums
NO अभी तक इसे ठीक नहीं किया गया है.
YES वीडियो को जोड़ा गया या स्प्लिट किया गया है.