Package google.ads.drx.video.v1

इंडेक्स

AdBreakNotificationService

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

CreateAdBreak

rpc CreateAdBreak(CreateAdBreakRequest) returns (AdBreak)

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

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

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

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

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

rpc ListAdBreaks(ListAdBreaksRequest) returns (ListAdBreaksResponse)

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

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

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

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

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

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 की खास जानकारी देखें.

AdBreak

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

फ़ील्ड
name

string

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

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

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

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/PAAGlmbAICAAAAAAsoKGKGKNAIAmsnRfg==” - splice_insert(): "/DAvAAAAAAAAhAAANAWAAAAUAVIPf+/LbowsAAhAAAN.
pod_template_name

string

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

BreakState

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

BreakState

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

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

ClosedCaptionFormat

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

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

ClosedCaptionUrlInfo

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

फ़ील्ड
language_code

string

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

ClosedCaptionFormat

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

string

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

CreateAdBreakRequest

AdBreakNotificationService.CreateAdBreak के लिए अनुरोध.

फ़ील्ड
parent

string

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

string

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

string

यह LiveStreamEvent की पहचान करने का एक वैकल्पिक तरीका है, अगर वह GAM के किसी कॉन्टेंट से जुड़ा हुआ है. इसका फ़ॉर्मैट "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

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

GracenoteMetadata

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

फ़ील्ड
gracenote_id

string

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

string

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

ListAdBreaksRequest

AdBreakNotificationService.ListAdBreaks के लिए अनुरोध.

फ़ील्ड
parent

string

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

string

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

string

ज़रूरी नहीं. अगर LiveStreamEvent, GAM में मौजूद किसी कॉन्टेंट से जुड़ा है, तो इसकी पहचान करने का यह एक और तरीका है. यह "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>

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

SyndicatedVideoContentNames

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

फ़ील्ड
syndicated_video_content[]

string

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

UpdateVideoContentRequest

[VideoContent{/0}Service.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 अगर स्टेटस 'ब्लॉक किया गया' है, तो इस कॉन्टेंट के साथ कोई विज्ञापन नहीं दिखाया जाएगा.
DELETED कॉन्टेंट को Ad Manager में संग्रहित कर दिया जाएगा. अगर Ad Manager को 'मिटाया गया' के तौर पर मार्क किए गए कॉन्टेंट के लिए विज्ञापन का अनुरोध मिलता है, तो हाउस विज्ञापन या इन्वेंट्री यूनिट या टारगेटिंग की अन्य शर्तों के हिसाब से टारगेट किए गए विज्ञापन अब भी उस कॉन्टेंट के साथ दिखाए जा सकते हैं. विज्ञापनों को ब्लॉक करने के लिए, स्टेटस को 'ब्लॉक किया गया' पर सेट करें.

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 इस वीडियो को कंडिशन/स्प्लिट कर दिया गया है.