Package google.ads.drx.video.v1

সূচক

ভিডিওকন্টেন্টইনজেশন সার্ভিস

কন্টেন্ট ইনজেশনের জন্য একটি API পরিষেবা যা Google বিজ্ঞাপন ম্যানেজারে ভিডিও কন্টেন্ট এবং এর সাথে সম্পর্কিত মেটাডেটা তৈরি বা আপডেট করার অনুমতি দেয়।

ভিডিও কন্টেন্ট আপডেট করুন

rpc UpdateVideoContent( UpdateVideoContentRequest ) returns ( VideoContent )

নতুন কন্টেন্ট তৈরি করতে অথবা যদি কন্টেন্টটি ইতিমধ্যেই অ্যাড ম্যানেজারে থাকে, তাহলে এর মেটাডেটা আপডেট করার জন্য API। সফল হলে কন্টেন্ট অথবা ব্যর্থ হলে 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 ওভারভিউ দেখুন।

বন্ধ ক্যাপশনফরম্যাট

ক্লোজড ক্যাপশন ফাইলগুলি যে ফর্ম্যাটে থাকতে পারে।

এনামস
CLOSED_CAPTION_FORMAT_UNSPECIFIED বন্ধ ক্যাপশন ফর্ম্যাট নির্দিষ্ট করা হয়নি।
TTML অ্যাপ্লিকেশন/ttaf+xml
WEB_VTT টেক্সট/ভিটিটি

ক্লোজডক্যাপশনইউআরএলইনফো

একটি ক্লোজড ক্যাপশন ফাইলের মেটাডেটা।

ক্ষেত্র
language_code

string

IETF BCP-47 ভাষা কোডটি ক্লোজড ক্যাপশন ফাইলটি যে ভাষায় রয়েছে তা প্রতিনিধিত্ব করে।

closed_caption_format

ClosedCaptionFormat

ক্লোজড ক্যাপশন ফাইলের ফর্ম্যাট।

url

string

ক্লোজড ক্যাপশন ফাইলের url।

DynamicAdInsertionInfo সম্পর্কে

ডায়নামিক বিজ্ঞাপন সন্নিবেশ সম্পর্কিত তথ্য।

ক্ষেত্র
video_ingest_url_info

VideoIngestUrlInfo

কন্ডিশনিং এবং প্লেলিস্ট তৈরির জন্য ব্যবহৃত মাস্টার m3u8 ফাইলের একটি লিঙ্ক।

media_update_time

Timestamp

video_ingest_url_info-এ উল্লেখিত ভিডিও ফাইলটি শেষবার কখন পরিবর্তন করা হয়েছিল।

closed_caption_url_info[]

ClosedCaptionUrlInfo

ক্লোজড ক্যাপশন/সাবটাইটেল ফাইলের URL।

fw_caid

string

বিজ্ঞাপন টার্গেটিংয়ের জন্য ব্যবহৃত ফ্রিহুইল কাস্টম অ্যাসেট আইডি।

গ্রেসনোটমেটাডেটা

কন্টেন্টের জন্য গ্রেসনোট মেটাডেটা।

ক্ষেত্র
gracenote_id

string

আবশ্যক। কন্টেন্টের জন্য Gracenote ID উল্লেখ করে। এই বৈধ উপসর্গগুলির মধ্যে একটি থাকা আবশ্যক: 1. 'EP' - একটি সিরিজের পর্ব 2. 'MV' - সিনেমা 3. 'SP' - ক্রীড়া ইভেন্ট

gracenote_series_id

string

ঐচ্ছিক। এই ক্ষেত্রটি Gracenote সিরিজের ID বোঝায়। 'SH' এর সাথে প্রিফিক্স যুক্ত করতে হবে।

মেটাডেটা

কন্টেন্টের কাস্টম মেটাডেটা।

ক্ষেত্র
key_values

map<string, Value >

কন্টেন্টের কাস্টম মেটাডেটা একটি কী-মান জোড়া হিসেবে শনাক্ত করে। মানের জন্য শুধুমাত্র স্ট্রিং বা স্ট্রিং তালিকা গ্রহণ করা হয়।

সিন্ডিকেটডভিডিওকন্টেন্টনাম

সমস্ত সিন্ডিকেটেড কন্টেন্টের নামের তালিকা।

ক্ষেত্র
syndicated_video_content[]

string

সিন্ডিকেট করা কন্টেন্টের নামের পুনরাবৃত্তিমূলক ক্ষেত্র। তাদের অবশ্যই "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" ফর্ম্যাট থাকতে হবে এবং এই ক্ষেত্রটি ধারণকারী কন্টেন্টের সাথে একই নেটওয়ার্কের অন্তর্গত হতে হবে।

ভিডিও কন্টেন্ট রিকোয়েস্ট আপডেট করুন

[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 বিজ্ঞাপন ম্যানেজারের সেই কন্টেন্ট সোর্স আইডি যার সাথে এই কন্টেন্টটি যুক্ত হওয়া উচিত।

cms_content_id হল Google Ad Manager-এর CMS কন্টেন্ট আইডি, যা বিজ্ঞাপন অনুরোধের অংশ হিসেবে তৈরি করা হয়, যা সংশ্লিষ্ট ভিডিওর বিপরীতে কোন বিজ্ঞাপনগুলি বিজ্ঞাপন ম্যানেজার পরিবেশন করতে পারে তা সনাক্ত করে। এই মানটি সংখ্যাসূচক বা বর্ণানুক্রমিক হতে পারে।

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

কন্টেন্টের ডায়নামিক বিজ্ঞাপন সন্নিবেশ সম্পর্কিত মেটাডেটা।

ভিডিও কন্টেন্ট স্ট্যাটাস

কোনও কন্টেন্টের জন্য লক্ষ্যবস্তুযুক্ত বিজ্ঞাপন পরিবেশন করা বা না পরিবেশন করা স্ট্যাটাস বিকল্প।

এনামস
ACTIVE কন্টেন্ট-লক্ষ্যযুক্ত বিজ্ঞাপন পরিবেশিত হবে।
BLOCKED যদি স্ট্যাটাসটি ব্লক করা থাকে, তাহলে এই কন্টেন্টের বিরুদ্ধে কোনও বিজ্ঞাপন পরিবেশন করা হবে না।
DELETED কন্টেন্টটি অ্যাড ম্যানেজারে আর্কাইভ করা হবে। যদি অ্যাড ম্যানেজার মুছে ফেলা হিসেবে চিহ্নিত কন্টেন্টের জন্য বিজ্ঞাপনের অনুরোধ পায়, তাহলে হাউস বিজ্ঞাপন, অথবা ইনভেন্টরি ইউনিটগুলিতে লক্ষ্য করা বিজ্ঞাপন বা অন্যান্য টার্গেটিং মানদণ্ড এখনও এর বিরুদ্ধে কাজ করতে পারে। বিজ্ঞাপন ব্লক করতে, স্ট্যাটাসটি ব্লকড-এ সেট করুন।

ভিডিওকন্টেন্টসিন্ডিকেশন তথ্য

ক্যানোনিকাল কন্টেন্ট এবং সিন্ডিকেটেড কন্টেন্টের মধ্যে সম্পর্ক নির্দিষ্ট করার জন্য মেটাডেটা।

ক্ষেত্র
ইউনিয়ন ফিল্ড syndication । ভিডিওকন্টেন্টসিন্ডিয়েশনমেটাডেটাতে কেবল নিম্নলিখিতগুলির মধ্যে একটি থাকতে পারে। syndication নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
canonical_video_content

string

আদর্শ কন্টেন্টের নাম। এটির ফর্ম্যাট "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" হতে হবে এবং এই ফিল্ডটি থাকা কন্টেন্টের সাথে একই নেটওয়ার্কের অন্তর্গত হতে হবে।

syndicated_video_content_names

SyndicatedVideoContentNames

সিন্ডিকেটেড কন্টেন্টের একটি সংগ্রহ

ভিডিও ফরম্যাট

কোন ফর্ম্যাটে ভিডিও কন্টেন্ট এনকোড করা যেতে পারে।

এনামস
VIDEO_FORMAT_UNSPECIFIED ভিডিও ফর্ম্যাট নির্দিষ্ট করা হয়নি।
HLS অ্যাপ্লিকেশন/এক্স-এমপিইজি ইউআরএল
DASH অ্যাপ্লিকেশন/ড্যাশ+এক্সএমএল

ভিডিওইঞ্জেস্টইউআরএলইনফো

কন্ডিশনিং এবং প্লেলিস্ট তৈরির জন্য ব্যবহৃত m3u8 ফাইলের লিঙ্ক নির্দিষ্ট করে মেটাডেটা।

ক্ষেত্র
video_format

VideoFormat

ভিডিওটির ফর্ম্যাট।

video_preconditioned

VideoPreconditioned

মিড-রোল বিজ্ঞাপনের জন্য কন্টেন্টটি ইতিমধ্যেই শর্তযুক্ত কিনা তা নির্দেশ করার জন্য, যার অর্থ বিজ্ঞাপন বিরতির সময় আপনার বিভাগগুলি ইতিমধ্যেই বিভক্ত।

url

string

m3u8 ফাইলের লিঙ্ক।

ভিডিওপ্রিকন্ডিশনড

ভিডিও কন্টেন্টের শর্তাধীন অবস্থা।

এনামস
NO এখনও শর্তসাপেক্ষ নয়।
YES ভিডিওটি শর্তযুক্ত/স্প্লিট করা হয়েছে।